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ENHANCED BACKUP AND RECOVERY METHODOLOGY 

5 BACKGROUND OF THE INVENTION 

1, Technical Field: 

The present invention relates to information 
10 processing technology. More particularly, the present 
invention relates to providing means for improving the 
efficiency and reliability in backing up data. 

2. Description of Related Art: 

15 The UNIX operating system is a multi-user operating 

system supporting serial or network connected terminals 
for more than one user. It supports multi- tasking and a 
hierarchical directory structure for the organization and 
maintenance of files. UNIX is portable, requiring only 

20 the kernel (<10%) written in assembler, and supports a 
wide range of support tools including development, 
debuggers, and compilers. 

The UNIX operating system consists of the kernel, 
shell, and utilities. The kernel schedules tasks, manages 

25 data/ file access and storage, enforces security 

mechanisms, and performs all hardware access. The shell 
presents each user with a prompt, interprets commands 
typed by a user, executes user commands, and supports a 
custom environment for each user. Finally, the utilities 

30 provide file management (rm, cat, Is, rmdir, mkdir) , user 
management (passwd, chmod, chgrp) , process management 
(kill, ps), and printing (Ip, troff, pr) . 

A multi-user operating system allows more than one 
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user to share the same computer system at the same time. 
It does this by time-slicing the computer processor at 
regular intervals between the various people using the 
system. Each user gets a set percentage of some amount of 

5 time for instruction execution during the time each user 
has the processor. After a user's allotted time has 
expired, the operations system intervenes, saving the 
program's state (program code and data), and then starts 
running the next user's program (for the user's set 

10 percentage of time) . This process continues until, 
eventually, the first user has the processor again. 

It takes time to save/restore the program's state and 
switch from one program to another (called dispatching) . 
This action is performed by the kernel and must execute 

15 quickly, because it is important to spend the majority of 
time running user programs, not switching between them. 
The amount of time that is spent in the system state 
(i.e., running the kernel and performing tasks like 
switching between user programs) is called the system 

20 overhead and should typically be less than 10%. 

Switching between user programs in main memory is 
done by part of the kernel. Main system memory is divided 
into portions for the operating system and user programs. 
Kernel space is kept separate from user programs. Where 

25 there is insufficient main memory to run a program, some 
other program residing in main memory must be written out 
to a disk unit to create some free memory space. A 
decision is made about which program is the best candidate 
to swap out to disk. This process is called swapping. 

30 When the system becomes overloaded (i.e., where there are 
more people than the system can handle), the operating 
system spends most of its time shuttling programs between 
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main memory and the disk unit, and response time degrades . 

In UNIX operating systems, each user is presented 
with a shell. This is a program that displays the user 
prompt, handles user input, and displays output on the 
5 terminal. The shell program provides a mechanism for 
customizing each user's setup requirements, and storing 
this information for re-use (in a file called .profile) . 

When the UNIX operating system starts up, it also 
starts a system process (getty) which monitors the state 

10 of each terminal input line. When getty detects that a 
user has turned on a terminal, it presents the logon 
prompt; and once the password is validated, the UNIX 
system associates the shell program (such as sh) with that 
terminal (typically there are a number of different shells 

15 including ksh and csh) . Each user interacts with sh, 

which interprets each command typed. Internal commands 
are handled within the shell (set, unset); external 
commands are invoked as programs (Is, grep, sort, ps) . 

Multi-tasking operating systems permit more than one 

20 program to run at once. This is done in the same way as a 
multi-user system, by rapidly switching the processor 
between the various programs. OS/2, available from IBM 
Corporation, One New Orchard Road, Armonk, NY 10504; and 
Windows 95, available from Microsoft Corporation, One 

25 Microsoft Way, Redmond, WA 98052, are examples of 

multi-tasking single-user operating systems. UNIX is an 
example of a multi-tasking multi-user operating system. 
A multi-user system is also a multi-tasking system. This 
means that a user can run more than one program at once, 

30 using key selections to switch between them. 

Multi-tasking systems support foreground and background 
tasks. A foreground task is one the user interacts 
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directly with using the keyboard and screen. A background 
task is one that runs in the background (i.e., It does not 
have access to the screen or keyboard.). Background tasks 
include operations like printing, which can be spooled for 
5 later execution. 

The role of the operating system is to keep track of 
all the programs, allocating resources like disks, memory, 
and printer queues as required. To do this, it must 
ensure that one program does not get more than its fair 

10 share of the computer resources. The operating system 

does this by two methods: scheduling priority, and system 
semaphores. Each program is assigned a priority level. 
Higher priority tasks (like reading and writing to the 
disk) are performed more regularly. User programs may 

15 have their priority adjusted dynamically, upwards or 
downwards, depending upon their activity and available 
system resources. System semaphores are used by the 
operating system to control system resources. A program 
can be assigned a resource by getting a semaphore (via a 

20 system call to the operating system) . When the resource 
is no longer needed, the semaphore is returned to the 
operating system, which can then allocate it to another 
program. 

Disk drives and printers are serial in nature. This 
25 means that only one request can be performed at any one 
time. In order for more than one user to use these 
resources at once, the operating system manages them via 
queues. Each serial device is associated with a queue. 
When a user program wants access to the disk, for example, 
30 it sends the request to the queue associated with the 

disk. The operating system runs background tasks (called 
daemons) , which monitor these queues and service requests 
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from them. A request is then performed by this daemon 
process, and the results are sent back to the user's 
program . 

Multi-tasking systems provide a set of utilities for 
5 managing processes. In UNIX, these are ps (list 

processes), kill (kill a process), and & (run a process in 
the background) . In UNIX, all user programs and 
application software use the system call interface to 
access system resources like disks, printers, memory etc. 

10 The system call interface in UNIX provides a set of system 
calls (C functions) . The purpose of the system call 
interface is to provide system integrity. As all low 
level hardware access is under control of the operating 
system, this prevents a program from corrupting the 

15 system. 

The operating system, upon receiving a system call, 
validates its authenticity or permission, then executes it 
on behalf of the program, after which it returns the 
results. If the request is invalid or not authenticated, 

20 then the operating system does not perform the request but 
simply returns an error code to the program. The system 
call is accessible as a set of ' C functions, as the 
majority of UNIX is also written in Typical system 

calls are: _read - for reading from the disk unit; _write 

25 - for writing to the disk unit; „_getch - for reading a 
character from a terminal; _jputch - for writing a 
character to the terminal; and __ioctl - for controlling 
and setting device parameters. 

The fundamental structure that the UNIX operating 

30 system uses to store information is the file. A file is a 
sequence of bytes, typically 8 bits long, and is 
equivalent to a character. UNIX keeps track of files 
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internally by assigning each one a unique identifying 
number. These numbers, called i-node numbers, are used 
only within the UNIX operating system kernel itself. 
While UNIX uses i-node number to refer to files, it allows 
5 users to identify each file by a user-assigned name. A 
file name can be any sequence containing from one to 
fourteen characters . 

There are three types of files in the UNIX file 
system: (1) ordinary files, which may be executable 
10 programs, text, or other types of data used as input or 
produced as output from some operation; (2) directory 
files, which contain lists of files; and (3) special 
files, which provide a standard method of accessing I/O 
devices . 

15 UNIX provides users with a way of organizing files. 

Files may be grouped into directories. Internally, a 
directory is a file that contains the names of ordinary 
files and other directories, and their corresponding 
i-node numbers. Given the name of a file, UNIX looks in 

20 the file's directory and obtains the corresponding i-node 
number for the file. With this i-node number, UNIX can 
examine other internal tables to determine where the file 
is stored and make it accessible to the user. UNIX 
directories themselves have names, each of which may also 

25 contain fourteen characters. 

Just as directories provide a means for users to 
group files, UNIX supports the grouping of directories 
into a hierarchical file system. At the very top of a 
hierarchy is a directory. It may contain the names of 

30 individual files and the names of other directories. 

These, in turn, may contain the names of individual files 
and still other directories, and so on. A hierarchy of 
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files is the result. The UNIX file hierarchy resembles an 
upside-down tree, with its root at the top. The various 
directories branch out until they finally trace a path to 
the individual files, which correspond to the tree's 
5 leaves. The UNIX file system is described as 

"tree-structured," with a single directory. All the files 
that can be reached by tracing a path down through the 
directory hierarchy from the root directory constitute the 
file system. 

10 UNIX maintains a great deal of information about the 

files that it manages. For each file, the file system 
keeps track of the file's size, location, ownership, 
security, type, creation time, modification time, and 
access time. All of this information is maintained 

15 automatically by the file system as the files are created 
and used. UNIX file systems reside on mass storage 
devices such as disk files. These disk files may use 
fixed or removable type media, which may be rigid or 
flexible. UNIX organizes a disk as a sequence of blocks, 

20 which compose the file system. These blocks are usually 
either 512 or 2 048 bytes long. The contents of a file are 
stored in one or more blocks, which may be widely 
scattered on the disk. 

An ordinary file is addressed through the i-node 

25 structure. Each i-node is addressed by an index contained 
in an i-list. The i-list is generated based on the size 
of the file system, with larger file systems generally 
implying more files and, thus, larger i-lists. Each 
i-node contains thirteen 4-byte disk address elements. 

30 The direct i-node can contain up to ten block addresses. 

If the file is larger than this, then the eleventh address 
points to the first level indirect block. Address 12 and 
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address 13 are used for second level and third level 
indirect blocks, respectively, with the indirect 
addressing chain before the first data block growing by 
one level as each new address slot in the direct i-node is 
5 required. 

All input and output (I/O) is done by reading the 
writing files, because all peripheral devices, even 
terminals, are files in the file system. In a most 
general case, before reading and writing a file, it is 

10 necessary to inform the system of your intent to do so by 
opening the file. In order to write to a file, it may 
also be necessary to create it. When a file is opened or 
created (by way of the 'open' or ^create' system calls), 
the system checks for the right to do so and, if all is 

15 well, returns a non-negative integer called a file 

descriptor. Whenever I/O is to be done on this file, the 
file descriptor is used, instead of the name, to identify 
the file. This open file descriptor has associated with 
it a file table entry kept in the "process" space of the 

20 user who has opened the file. In UNIX terminology, the 

term "process" is used interchangeably with a program that 
is being executed. The file table entry contains 
information about an open file, including an i-node 
pointer for the file and the file pointer for the file, 

25 which defines the current position to be read or written 
in the file. All information about an open file is 
maintained by the system. 

In conventional UNIX systems, all input and output is 
done by two system calls, 'read' and 'write, ' which are 

30 accessed from programs having functions of the same name. 
For both system calls, the first argument is a file 
descriptor. The second argument is a pointer to a buffer 
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that serves as the data source or destination. The third 
argument is the number of bytes to be transferred. Each 
'read' or 'write' system call counts the number of bytes 
transferred. On reading, the number of bytes returned may 
5 be less than the number requested, because fewer than the 
number requested remain to be read. A return value of 
zero implies end of file, a return value of -1 indicates 
an error of some sort. For writing, the value returned is 
the number of bytes actually written. An error has 

10 occurred if this is not equal to the number which was 
supposed to be written. 

The parameters of the x read' and x write' system calls 
may be manipulated by the application program that is 
accessing the file. The application must, therefore, be 

15 sensitive to and take advantage of the multi-level store 
characteristics inherent in a standard system memory 
hierarchy. It is advantageous, from the application 
perspective, if the system memory components can be viewed 
as a single level hierarchy. If this is properly done, 

20 the application could dispense with most of the I/O 
overhead . 

One advantage of using a UNIX based operating system 
over other operating systems is that data can be isolated 
or segregated into different volume groups (VGs) . The 

25 omnipresent "rootvg" contains the operating system 
details, and it is from this volume group that the 
computer runs. Similarly, data or application volume 
groups can also be created. The advantage of such volume 
groups is that, unlike competitive operating systems, an 

30 upgrade to a UNIX based operating system will only impact 
the rootvg, and will not affect application data. 
Analogously, application upgrades will not impact the 
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operating system in any way, presuming that the 
application has been segregated into its own VG. 

Faults are inevitable in digital computer systems due 
to such things as the complexity of the circuits and the 
5 associated electromechanical devices. To permit system 
operation, even after the occurrence of a fault, the art 
has developed a number of fault-tolerant designs. 
Improved fault-tolerant digital data processing systems 
include redundant functional units, e.g., duplicate CPUs, 

10 memories, and peripheral controllers interconnected along 
a common system bus. Each of a pair of functional units 
responds identically to input received from the bus. In 
the outputs, if a pair of functional units do not agree, 
that pair of units is taken off-line, and another pair of 

15 functional units (a "spare") continues to function in its 
place. 

Even with the recent developments in fault-tolerant 
systems, there are characteristics of UNIX systems that 
make them difficult to adapt to conventional 

20 fault- tolerant operation. An important element of 

fault-tolerant systems is a maintenance and diagnostic 
system that automatically monitors the condition (or 
"state") of functional units of the data processing 
system, particularly those that are more readily 

25 replaceable ("field replaceable units," or FRUs) . The 
complexity of UNIX based systems requires that such 
fault-tolerant systems maintenance and diagnostic systems 
(or "state machines") have capabilities that require 
state-of-the-art systems maintenance and diagnostics 

30 systems. 

Disk failure is the most common hardware failure in 
the storage system, followed by failure of adapters and 
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power supplies. Protection against disk failure primarily 
involves the configuration of the logical volumes. To 
protect against adapter and power supply failures, a 
popular configuration includes two adapters and at least 
5 one disk per adapter, with mirroring across adapters, 
without regard to the number of active blocks in the 
volume group. By mirroring the original data, copies are 
available in case of an interruption. Read efficiency is 
also improved because the logical volume manager is free 

10 to choose a less busy drive from which to read. RAID 

(redundant array of independent disks) is an alternative 
mirroring technique where data is striped block by 
(512-byte) block, but portions of several (not necessarily 
all) of the drives are set aside to hold parity 

15 information. This spreads the load of writing parity 
information more evenly. 

In today's information systems (IS) environment, 
backup and recovery are frequently a subject of great 
complexity and, therefore, an area in which lapses may 

20 occur. For instance, on UNIX systems, file backup may be 
enacted via mksysb (accomplished directly by the operating 
system) , via specialized backup and recovery software, 
such as ADSM (ADSTAR distributed storage network (ADSTAR 
is a registered trademark of IBM) ) , available from IBM, or 

25 via some method built directly into an application for 

backing up its own data sets. Quite often, administrators 
are familiar with the usage of these divergent techniques 
and, accordingly, enact multiple backup methods on a given 
system within a finite and regularly scheduled timeframe. 

30 The result is a chaotic backup plan, which requires great 
planning and care to ensure that all necessary filesystems 
are backed up in a timely and thoughtful manner. 



12 

Docket No. AT9-99-234 

Typically, backup is accomplished using either a "one 
size fits all" approach, where all data needs are subject 
to the same backup method. Alternatively, the 
administrator grapples with the management of various 
5 tools in an ad hoc manner. Neither process is an 

efficient use of the system administrator's time nor does 
either provide adequate backup results for the systems 
under the administrator's control. 

It would be advantageous to provide a framework for a 

10 more efficient means for backing up data using diverse 
techniques. It would also be advantageous to provide a 
means for reducing the reliance on the skill level of the 
system administrator for implementing system backups. It 
would be further advantageous to provide a more automated 

15 means for backing up systems, thereby relieving the system 
administrator of some of the time constraints involving 
system backup. Additionally, it would be advantageous to 
provide system administrators with an easy-to-use and 
flexible backup tool that allows administrators to backup 

20 systems anytime, regardless of system usage. 
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SUMMARY OF THE INVENTION 

The present invention relates to a system and method 
5 for the automated backing up of filesystems. Initially, a 
table file is built which lists at least the filesystems 
to be backed up. It also may list the type of backup 
techniques to be used for a specific filesystem, the 
filesystem' s logical location, and the number of copies to 
10 be made. The table file is checked for syntax and is then 
available for other routines. An automated script may be 
used for building the table, and then it may be manually 
edited if necessary. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

The novel features believed characteristic of the 
invention are set forth in the appended claims. The 
5 invention itself, however, as well as a preferred mode of 
use, further objectives and advantages thereof, will best 
be understood by reference to the following detailed 
description of an illustrative embodiment when read in 
conjunction with the accompanying drawings, wherein: 
10 Figure 1 is a pictorial representation of a 

distributed data processing system in which the present 
invention may be implemented; 

Figure 2 is a block diagram depicting a data 
processing system that may be implemented as a server in 
15 accordance with a preferred embodiment of the present 
invention; 

Figure 3 is a block diagram illustrating a data 
processing system in which the present invention may be 
implemented; 

20 Figure 4 is a flowchart of a process for building a 

table file; 

Figure 5 is a flowchart depicting the process for 
backing up filesystems using the backup selection table 
file created in Figure 4; 

25 Figure 6 is a flow chart depicting a process for 

resolving a backup problem when using a backup selection 
table file in accordance with a preferred embodiment of 
the present invention; 

Figures 7A - 7E depict a script called 

30 "fscpbktab_unlock.ksh" , which will remove locks on the 
table file that prevent various backup operations from 



15 

Docket No. AT9-99-234 

interfering with each other; 

Figures 8A - 8G depict a script called 

"fscpbktab_build.ksh" , which will build the table file 

based on an inventory of the filesystems actually present; 
5 Figures 9A - 9G depict a script called 

"fscpbktab_check.ksh" , which will check the table file for 

syntax and content errors; 

Figures 10A - 10E depict a script called 

" f scpbk_sync .ksh" , which will detect mirrored logical 
10 volumes where mirrored partitions in the logical volume 

are stale; 

Figures 11A - 11H depict a script called 
"fscpbk_select .ksh" that will parse the table file and 
select filesystems for backup; 

15 Figures 12A - 12J depict a script called 

"f scpbkjoack.ksh" that will parse the table file and 
perform the actual backup of filesystems; and 
Figures 13A - 13G depict a script called 
"fscpbk„merge.ksh" that will parse the table file and 

20 merge those filesystems that have been split into separate 
primary and alternate filesystems. 
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DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

With reference now to the figures, Figure 1 is a 
pictorial representation of a distributed data processing 

5 system in which the present invention may be implemented. 
Distributed data processing system 100 is a network of 
computers in which the present invention may be 
implemented. Distributed data processing system 100 
contains a network 102, which is the medium used to 

10 provide communications links between various devices and 
computers connected together within distributed data 
processing system 100. Network 102 may include permanent 
connections, such as wire or fiber optic cables, or 
temporary connections made through telephone connections. 

15 In the depicted example, a server 104 is connected to 

network 102 along with storage unit 106. In addition, 
clients 108, 110 and 112 also are connected to network 
102. These clients 108, 110 and 112 may be, for example, 
personal computers or network computers. For purposes of 

20 this application, a network computer is any computer 

coupled to a network, which receives a program or other 
application from another computer coupled to the network. 
In the depicted example, server 104 provides data, such as 
boot files, operating system images, and applications to 

25 clients 108, 110 and 112. Clients 108, 110 and 112 are 

clients to server 104. Distributed data processing system 
100 may include additional servers, clients, and other 
devices not shown. 

In the depicted example, distributed data processing 

30 system 100 is the Internet, with network 102 representing 
a worldwide collection of networks and gateways that use 
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the TCP/IP suite of protocols to communicate with one 
another. At the heart of the Internet is a backbone of 
high-speed data communication lines between major nodes or 
host computers, consisting of thousands of commercial, 
5 government, education, and other computer systems that 
route data and messages. Of course, distributed data 
processing system 100 also may be implemented as a number 
of different types of networks, such as, for example, an 
intranet, a local area network (LAN) , or a wide area 

10 network (WAN) . Figure 1 is intended as an example and not 
as an architectural limitation for the present invention. 

Referring to Figure 2, a block diagram depicts a data 
processing system which may be implemented as a server, 
such as server 104 in Figure 1, in accordance with a 

15 preferred embodiment of the present invention. Data 

processing system 200 may be a symmetric multiprocessor 
(SMP) system including a plurality of processors 202 and 
204 connected to system bus 206. Alternatively, a single 
processor system may be employed. Also connected to 

20 system bus 206 is memory controller /cache 208, which 

provides an interface to local memory 209. I/O bus bridge 
210 is connected to system bus 206 and provides an 
interface to I/O bus 212. Memory controller/cache 208 and 
I/O bus bridge 210 may be integrated as depicted. 

25 Peripheral component interconnect (PCI) bus bridge 

214 connected to I/O bus 212 provides an interface to PCI 
local bus 216. A number of modems may be connected to PCI 
bus 216. Typical PCI bus implementations support four PCI 
expansion slots or add-in connectors. Communications 

30 links to network computers 108, 110 and 112 in Figure 1 
may be provided through modem 218 and network adapter 220 
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connected to PCI local bus 216 through add- in boards. 
Additional PCI bus bridges 222 and 224 provide interfaces 
for additional PCI buses 226 and 228, from which 
additional modems or network adapters may be supported. A 

5 memory-mapped graphics adapter 230 and hard disk 232 may 
also be connected to I/O bus 212 as depicted, either 
directly or indirectly. 

With reference now to Figure 3, a block diagram 
illustrates a data processing system in which the present 

10 invention may be implemented. Data processing system 300 
is an example of a client computer. Data processing 
system 300 employs a peripheral component interconnect 
(PCI) local bus architecture. Although the depicted 
example employs a PCI bus, other bus architectures, such 

15 as Micro Channel and ISA, may be used. Processor 302 and 
main memory 304 are connected to PCI local bus 306 through 
PCI bridge 308. PCI bridge 308 also may include an 
integrated memory controller and cache memory for 
processor 302. Additional connections to PCI local bus 

20 306 may be made through direct component interconnection 
or through add- in boards. In the depicted example, local 
area network (LAN) adapter 310, SCSI host bus adapter 312, 
and expansion bus interface 314 are connected to PCI local 
bus 306 by direct component connection. In contrast, 

25 audio adapter 316, graphics adapter 318, and audio/video 
adapter 319 are connected to PCI local bus 306 by add-in 
boards inserted into expansion slots. Expansion bus 
interface 314 provides a connection for a keyboard and 
mouse adapter 320, modem 322, and additional memory 324. 

30 SCSI host bus adapter 312 provides a connection for hard 
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disk drive 326, tape drive 328, and CD-ROM drive 330. 
Typical PCI local bus implementations support three or 
four PCI expansion slots or add- in connectors. 

An operating system runs on processor 302 and is used 
5 to coordinate and provide control of various components 
within data processing system 300 in Figure 3. The 
operating system may be a commercially available operating 
system such as a UNIX based operating system, AIX for 
instance, which is available from International Business 

10 Machines Corporation. "AIX" is a trademark of 

International Business Machines Corporation. Other 
operating systems include OS/2. An object oriented 
programming system, such as Java, may run in conjunction 
with the operating system and provide calls to the 

15 operating system from Java programs or applications 

executing on data processing system 300. "Java" is a 
trademark of Sun Microsystems, Inc. Instructions for the 
operating system, the object-oriented operating system, 
and applications or programs are located on storage 

20 devices, such as hard disk drive 326, and may be loaded 
into main memory 304 for execution by processor 302. 

Those of ordinary skill in the art will appreciate 
that the hardware in Figure 3 may vary depending on the 
implementation. Other internal hardware or peripheral 

25 devices, such as flash ROM (or equivalent nonvolatile 

memory) or optical disk drives and the like, may be used 
in addition to or in place of the hardware depicted in 
Figure 3. Also, the processes of the present invention 
may be applied to a multiprocessor data processing system. 

30 For example, data processing system 300, if 

optionally configured as a network computer, may not 
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include SCSI host bus adapter 312, hard disk drive 326, 
tape drive 328, and CD-ROM 330, as noted by dotted line 
332 in Figure 3, denoting optional inclusion. In that 
case, the computer, to be properly called a client 

5 computer, must include some type of network communication 
interface, such as LAN adapter 310, modem 322, or the 
like. As another example, data processing system 300 may 
be a stand-alone system configured to be bootable without 
relying on some type of network communication interface, 

10 whether or not data processing system 300 comprises some 
type of network communication interface. As a further 
example, data processing system 300 may be a Personal 
Digital Assistant (PDA) device which is configured with 
ROM and/or flash ROM in order to provide nonvolatile 

15 memory for storing operating system files and/or 
user-generated data. 

The depicted example in Figure 3, as well as 
above-described examples, are not meant to imply 
architectural limitations . 

20 As discussed above, system administrators are faced 

with the task of being very familiar with a number of 
diverse backup methodologies in order to implement a 
coherent system for backing up the filesystems under the 
administrator's care. Often, administrators must be 

25 familiar with the usage of these divergent techniques and, 
accordingly, enact multiple backup methods on a given 
system within a finite and regularly scheduled time frame. 
This situation may lead to system administrators delaying 
backing up systems which the administrator is less 

30 familiar and/or is more difficult to implement due the 
uniqueness of the system backup scheme. 
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Introduced into this environment, an ideal backup 
tool would be one that permits the operation of different 
backup utilities and allows them to be controlled from a 
single point of interaction. Furthermore, besides 
5 providing a concentration of diverse methods beneath the 
same control mechanism, an exemplary backup tool would 
also create a master list of filesystems to be backed up 
automatically; it would allow the administrator to select 
specific backup methodologies for each filesystem (or even 

10 exempt filesystems from backup) ; and it would perform an 
audit function to ensure that the administrator does not 
inadvertently corrupt the control file during such 
modifications • 

A preferred embodiment of the present invention, as 

15 manifested in the discussion and figures below, provides a 
single point of administration for diverse backup 
methodologies, and it automatically creates and audits 
backup control tables. It also permits administrator 
customization to exempt or modify filesystem specifics. 

20 Furthermore, the enhanced backup and recovery system 

detailed herein can also work with mirrored filesystems, 
taking one copy offline to make backups and then 
re-merging the mirror when the backup is complete. A 
preferred embodiment of the present invention may, in 

25 varying degrees, be applicable to and extendible across a 
variety of operating systems. Therefore, the 
implementation of an automating method for filesystem 
backup of the preset invention is not limited to AIX or 
UNIX type operating systems but, instead, may be 

30 incorporated into any type of operating system. However, 
the exemplary embodiment described herein resides on a 
UNIX system; therefore, the description of this 
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implementation pertains particularly to such computer 
systems . 

An important feature of the present invention is the 
building of a backup selection table file or configuration 

5 table. This table file (in colon-delimited format similar 
to the /etc/inittab file) indicates which filesystems are 
to be backed up. For filesystems on mirrored logical 
volumes, it will indicate what to name the temporary 
filesystems and logical volumes that result from the 

10 split. In accordance with a preferred embodiment of the 
present invention, the filesystem backup selection table 
file may be formatted as: 

be :pf s:plv:c :af s :alv 

15 where, "be' 7 (Backup Control) is one of the following: 

xb -> AIX Backup (Level 0 AIX FS Backup) 

no -> No Backup (Skip filesystem) 

as -> ADSM Selective Backup 

20 ai -> ADSM Incremental Backup 

aa -> ADSM Archive 

The backup control tells the system which backup 

technique to use for the filesystem designated on that 

table command line. "pfs" (Primary Filesystem) is the 

25 full path of the standard filesystem, and "plv" (Primary 
Logical Volume) is the AIX LV name of the logical volume 
containing the primary filesystem. "c" (Copies) relates 
to the number of AIX LVM copies of the logical volume 
containing the primary filesystem. The copy number must 

30 be numeric 1, 2 or 3 for AIX filesystems; however, other 
flavors of UNIX may support more or fewer copies. "afs" 
(Alternate Filesystem) is the full path of the mirror copy 
filesystem and must be unique. u alv" (Alternate Logical 
Volume) is the AIX LV name of the logical volume 
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containing the alternate f ilesystem and must also be 
unique. An example of a mirrored home f ilesystem to be 
backed up using an AIX backup command: 

xb: /home:hdl:2 : /al t /home : alt Ivh 

5 Each command line relates to a separate filesystem to 

be backed up, specifying the backup technique, the 
physical and logical locations of the filesystem, the 
number of mirror copies present for the logical volume 
and, finally, the physical and logical location where the 

10 copies are to be located once they are made. An 

administrator may, at any time, edit any line on the 
backup selection table file, or may instead edit the 
entire table. However, during backing up operations where 
the table file is being used in a backup process, the 

15 table is locked in order to avoid conflict between backup 
operations. Unlocking the table is possible for 
troubleshooting or fixing a problem with a backup 
operation. The table file uses a two stage lock to 
prevent inadvertant modification of the file and the 

20 resulting possible disruption of backup operations. The 
first stage of the lock is the use of a separate lock 
file. The presence or absence of the lock file is used by 
the constituent programs to signal whether it is safe or 
appropriate to modify or manipulate the table file itself. 

25 The second stage of the lock is the manipulation of file 
access permissions on the table file itself. During key 
periods, the table file permissions are set to prevent any 
other users or outside processes from reading, editing, 
deleting, or otherwise manipulating the table file. 

30 During safe periods, the table file permissions are 

returned to nominal settings. Syntax is crucial to the 
proper parsing of the table file, so, in a preferred 
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embodiment of the present invention, syntax must be 
checked before any script will accept data in the table 
file for processing. 

In a preferred embodiment of the present invention, 
5 for the mirrored filesystems, it will be the temporary 
filesystems that are backed up, meaning that the backups 
will contain the names of the filesystems and directories 
of the temporary (alternate) filesystem, not the primary 
(active) filesystem. The table file (created by the 

10 11 f scpbktab_build.ksh" script below) is self documenting. 

A flowchart depicting a process for building and 
managing a table file is depicted in Figure 4. The 
process begins with the table file being tested for 
accessibility (step 402) . If the table is locked, it is 

15 assumed that the backup process is currently underway and 
that it is not desired to change the table file and 
confuse backup operations in progress. It is also 
possible that the table file may remain locked in the 
event of a backup problem or hang state. In that case, 

20 the system administrator needs to be able to resolve the 
problem and release the table lock condition before the 
next backup operation. Therefore, the table file must be 
unlocked, allowing the system administrator access to the 
table file and other backup operations to be performed 

25 subsequent to the administrator fixing the bug (step 404) . 
Unlocking the table involves a number of steps for 
updating error logs and checking syntax for active 
commands within the table. 

While it is possible to manually perform each of the 

30 steps in unlocking the table file, there is a high 
probability that additional errors may be created by 
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manually unlocking the table. Therefore, in accordance 
with a preferred embodiment of the present invention, a 
script called " f scpbktab_unlock.ksh" is show in Figures 7A 
through 7E. Returning to step 404 in Figure 4, the 

5 process proceeds to the problem solving phase depicted in 
Figure 6 below. 

Returning to step 402, assuming that a locked table 
is not found, the administrator may proceed with building 
or editing the table. First, it must be determined if a 

10 table is in existence (step 406) . If a table file exists, 
the process flows to step 412, where a decision is made 
whether or not to edit the table. Returning to step 406, 
if no table file exists, a decision is made whether to 
manually build the table (step 408). If the decision is 

15 made to manually build the table file, then the table file 
is manually created (step 419) and the process again 
returns to step 412; otherwise, the table is built by 
invoking an automated table building script (step 410) . 
In accordance with a preferred embodiment of the 

20 present invention, an automated table building script 

w f scpbktab_build.ksh" is shown in Figures 8A through 8G. 
This script automatically builds the table file based on 
an inventory of the filesystems actually present. A 
default backup method will be the AIX command w backup by 

25 i-node," and will be set for each present filesystem. 

Once a table file has been built, the process again flows 
to step 412, where a decision is made whether the system 
administrator is to edit the table file. 

If the administrator intends to edit the table by 

30 hand, the process flows to step 414, where the editing is 
performed. Editing the table file may include actions 
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such as selecting which filesystems to backup, deselecting 
filesys terns not to backup, changing the backup technique, 
or designating a new unique path for a copy. Returning to 
step 412, if no hand entry is needed, the table file is 
5 checked for syntax and context errors (step 416) . 

An error free table is crucial for successfully 
backing up the filesystems; therefore, a script has been 
developed for automatically checking the table file 
following entries in the table. In accordance with a 

10 preferred embodiment of the present invention, a next 

script called w f scpbktab_check.ksh" is shown in Figures 9A 
through 9G. This script checks the table file for syntax 
and content errors. The system administrator may use this 
script to check the table file after it has been 

15 automatically built or hand edited. Importantly, any 

scripts that use the table file will check the table file 
for syntax checking prior to using the file. If a script 
determines that a table file has been edited subsequent to 
the last syntax check, the script will not use the table 

20 file but will issue an error. 

Once a syntax- free table file is available for the 
system, the administrator may invoke the backup tool for 
automatically backing up filesystems. Therefore, the 
backup tool for backing up the filesystems may be invoked 

25 anytime thereafter. An important benefit of the present 
invention is that all of the criteria needed for backing 
up the filesystems have been pre-assembled for the system 
administrator in the table file. The administrator is 
freed from the tedious tasks associated with determining 

30 which filesystems to back up and determining an 

appropriate backup method for each filesystem, as well as 
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performing the checks and validations needed to ensure 
compliance with a specific operating system. By 
tabulating the criteria needed for backing up filesystems 
in a script-usable form, the present invention gives the 

5 system administrator the flexibility to perform a backup 
operation any time it is convenient for the system 
administrator . 

Figure 5 is a flowchart depicting the process for 
backing up filesystems using the backup selection table 

10 file created in Figure 4 above. The process begins by 
synchronizing the mirrored logical volumes (step 502) . 
Because stale partitions must be updated prior to backing 
up the system, the first step is to sync or re-sync the 
entire system, thereby eliminating any potential problems 

15 related to backing up stale data. In accordance with a 
preferred embodiment of the present invention, a next 
script called " f scpbk_sync . ksh" is shown in Figures 10A 
through 10E. The depicted script will detect mirrored 
logical volumes where mirrored partitions in the logical 

20 volume are stale. Stale logical volumes will be 

resynchronized and, thus, ready for backing up if they are 
selected for backup. When invoked, f scpbk_sync .ksh 
re-syncs all stale logical volumes without regard to the 
filesystems specified in the backup selection table file. 

25 Returning to the process depicted in Figure 5, a 

check is made to determine if applications are presently 
running (step 504) . This is depicted in the present 
embodiment as a separate step, because there might be some 
occasions when the data structure table file is relatively 

30 uncomplicated and the system administrator may perform 
backup operations with some confidence that the 
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filesystems to be backed up are not being accessed or 
modified at backup time. In that case, the system 
administrator merely calls the table file (step 516), 
selects filesystems to backup (step 518) , splits any 
5 mirrored filesystems (step 520) and backs up the 
filesystems using the table file (step 518) . 

However, as discussed above, an important advantage 
of the present invention is to relieve the system 
administrator of the burden of having to manually backup 

10 selected filesystems. Therefore, a preferred embodiment 
of the present invention is depicted in a script called 
*f scpbk_back.ksh" shown in Figures 12A through 12 J. This 
script parses the table file and performs the actual 
filesystem backups. If applicable, it also merges those 

15 filesystems that have been split into separate primary 
(active) and alternate (inactive) filesystems. This 
script returns various error codes if it is unable to 
locate the table file or the filesystems, and/or if it is 
unable to backup or merge the filesystems. 

20 f scpbk_back.ksh performs the filesystem backup by first 
calling the table file; thus, the system administrator is 
relieved of having to perform step 516. 

Returning to step 504, in many cases the system 
administrator may not know for certain that a filesystem 

25 to be backed up will not be used during the time that the 
filesystem is being backed up. Filesystems that are 
available twenty- four hours a day are particularly 
difficult to schedule. Therefore, an administrator may 
instead freeze the running applications (step 506) and 

30 call the table file (step 508) . The administrator then 
determines which filesystems to back up (step 510) . 
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Practically speaking, because f scpbk_back . ksh actually 
performs the filesystem backing up, what is being selected 
are filesystems which cannot safely be backed up in their 
present state, such as mirrored filesystems which are 
5 available twenty- four hours a day or are presently frozen. 
The system administrator splits all mirrored filesystems 
that might be in use at backup time, including the frozen 
filesystems (step 512) . 

In accordance with a preferred embodiment of the 

10 present invention, a script called w f scpbk„select . ksh" is 
shown Figures 13A through 13G. This script automatically 
parses the table file and selects filesystems that must be 
split for backup. Most importantly, it will split those 
filesystems that are mirrored into separate primary 

15 (active) and alternate (inactive) filesystems. This 

script will return various error codes if it is unable to 
locate the table file or the filesystems, and/or if it is 
unable to split the filesystems* By invoking 
f scpbk„select .ksh, steps 508, 510 and 512 are 

20 automatically performed by the script and, thus, the 
administrator is freed from those tasks. Furthermore, 
f scpbk_select .ksh accesses the table file for the name of 
the temporary filesystems and logical volumes that result 
from the split. 

25 Returning to Figure 5, frozen applications are thawed 

and allowed to continue at the point where they were 
frozen (step 514) . The process can be further automated 
by devising script which looks for running applications, 
freezes them at a convenient point in their process cycle, 

30 calls and executes the f scpbkjselect .ksh script and, once 
f scpbk„select .ksh returns the split filesystems, thaws the 
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frozen file. One of ordinary skill in the art could 
easily create such a script using the above description of 
its f unc t i ona 1 i t y . 

Once all filesystems are in condition (mirrored 

5 filesystems split) for backing up, the system 

administrator can proceed with the backup operation at any 
time (step 520) . Again, the script f scpbkjoack. ksh may be 
employed for automatically backing up the filesystems. 
The process then ends with the filesystems being backed 

10 up. 

As alluded to above, when a problem occurs in the 
backup operation, the backup selection table file is most 
probably in need of editing. Figure 6 is a flowchart 
depicting a process for resolving a backup problem when 

15 using a backup selection table file in accordance with a 
preferred embodiment of the present invention. The 
process begins with the detection of a backup problem 
(step 602) . The system administrator may then call the 
table file (step 604) and determine if it is locked (step 

20 606) . If not, the process flows to step 610, where a 
determination is made whether the table file needs 
editing. On the other hand, if the table file is locked, 
it may be unlocked using the script f scpbktab_unlock.ksh 
as described above (step 608) . The table file might also 

25 be manually unlocked. 

Next, the determination is made as to whether the 
table file needs editing (step 610) . If the table file 
does not need to be edited, the process flows to step 614, 
where any split filesystems that are present are merged, 

30 thus allowing the backup process on those filesystems to 
continue at a later time. Returning to step 610, it is 
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generally assumed that the table file itself may either 
contain an error or that a problematic backup operation 
might need to be temporarily unselected while the backup 
problem is being studied. This allows other backups to 
5 continue. If so, the table file is edited (step 612). 

Once the table file has been edited, the process flows to 
step 614, where the split filesystems are merged, allowing 
the backup process on those filesystems to continue at a 
later time. 

10 Below are descriptions of preferred embodiments of 

scripts used in describing the present invention. 

Referring to Figures 7A through 7E, a script called 
"fscpbktab_unlock.ksh n removes locks on the table file 
that prevent various backup operations from interfering 

15 with each other. This script is generally only used for 
diagnostic or problem solving purposes. 

Referring to Figures 8A through 8G, a script called 
"fscpbktab_.build.ksh" builds the table file based on an 
inventory of the filesystems actually present. The system 

20 administrator may then edit the table file to select which 
filesystems to backup or not to backup. The default 
backup method will be the AIX command "backup by inode." 
The backup usually creates what is called an AIX "stacked 
tape . " 

25 Referring to Figures 9A through 9G, a script called 

"f scpbktab_check.ksh" will check the table file for syntax 
and content errors. The system administrator may use this 
script to check the table file after it has been edited, 
to select which filesystems to backup. 

30 Referring to Figures 10A through 10E # a script called 

" fscpbk_sync.ksh" will detect mirrored logical volumes 
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where mirrored partitions in the logical volume are stale. 
Stale logical volumes will be resynchronized. 

Referring to Figures 11A through 11H, a script called 
" fscpbk_select.ksh" will parse the table file and select 
5 filesystems for backup. Most importantly, it will split 
those filesystems that are mirrored into separate primary 
(active) and alternate (inactive) filesystems. This 
script will return various error codes if it is unable to 
locate the table file, the filesystems, and/or is unable 

10 to split the filesystems. 

Referring to Figures 12A - 12J, a script called 
"fscpbkjoack.ksh" , will parse the table file and perform 
the actual backup of filesystems. It will also merge 
those filesystems that have been split into separate 

15 primary (active) and alternate (inactive) filesystems. 
This script will return various error codes if it is 
unable to locate the table file or the filesystems, and/or 
if it is unable to backup or merge the filesystems. 

Referring to Figures 13A through 13G, a script called 

20 "f scpbk_merge.ksh" will parse the table file and merge 
those filesystems that have been split into separate 
primary and alternate filesystems. This merge action is 
performed without backing up any data. This script is 
generally used only for diagnostic or problem solving 

25 purposes . 

It is important to note that, while the present 
invention has been described in the context of a fully 
functioning data processing system, those of ordinary 
skill in the art will appreciate that the processes of the 

30 present invention are capable of being distributed in the 
form of a computer readable medium of instructions and a 
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variety of forms, and that the present invention applies 
equally regardless of the particular type of signal 
bearing media actually used to carry out the distribution* 
Examples of computer readable media include recordable 
5 type media, such as floppy discs, hard disk drives, RAM, 
and CD-ROMs and transmission- type media, such as digital 
and analog communications links. 

The description of the present invention has been 
presented for purposes of illustration and description but 

10 is not intended to be exhaustive or limited to the 

invention in the form disclosed. Many modifications and 
variations will be apparent to those of ordinary skill in 
the art. The embodiment was chosen and described in order 
to best explain the principles of the invention and the 

15 practical application, and to enable others of ordinary 
skill in the art to understand the invention for various 
embodiments with various modifications as are suited to 
the particular use contemplated. 
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CLAIMS: 

What is claimed is: 

1. A data processing system implemented method for 
5 automating a filesystem backup process, comprising: 

building a table file, wherein the table file 
lists filesystems to be backed up; 
accessing the table file; and 
backing up a filesystem listed in the table 

10 file. 

2. The method recited in claim 1, wherein the table file 
contains a backup technique to be used for backing up each 
listed filesystem. 

15 

3. The method recited in claim 2, wherein backing up 
further comprises using a backup technique listed in the 
table file. 

20 4. The method recited in claim 1, wherein the table file 
further comprises a logical location of the filesystem to 
be backed up. 

5. The method recited in claim 1, wherein the table file 
25 further comprises a logical location for at least one 

backup copy. 

6. The method recited in claim 1, wherein the table file 
further comprises a number of copies to be created. 

30 

7. The method recited in claim 1, further comprising, 
prior to backing up the filesystem, splitting the 
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filesystem on the basis of the filesystem being in use 
during backing up the filesystem. 

8. The method recited in claim 1, further comprising, 
5 prior to backing up the filesystem, locking the table 

file. 

9. The method recited in claim 8, further comprising: 

detecting an error in backing up the filesystem; 
10 unlocking the table file; and 

editing the table file. 

10. The method recited in claim 1, further comprising, 
prior to backing up the filesystem, re-syncing logical 

15 volumes servicing the filesystems. 

11. The method recited in claim 1, wherein building a 
table file is performed by an automated script. 

20 12. The method recited in claim 1, wherein accessing a 

table file is a function performed by an automated script. 

13. The method recited in claim 1, wherein backing up the 
filesystem is performed by an automated script. 

25 

14. The method recited in claim 9, wherein unlocking the 
table file is performed by an automated script. 

15. The method recited in claim 10, wherein re-syncing 
30 logical volumes is performed by an automated script. 



16. The method recited in claim 7, wherein splitting the 
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filesystem is performed by an automated script. 

17. A data processing system for automating a filesystem 
backup process, comprising: 

building means for building a table file, 
wherein the table file lists filesystems to be backed 
up; 

accessing means for accessing the table file; 

and 

backing means for backing up a filesystem listed 
in the table file. 

18. The system recited in claim 17, wherein the table 
file contains a backup technique to be used for backing up 

15 each listed filesystem. 

19. The system recited in claim 18, wherein backing up 
further comprises using a backup technique listed in the 
table file. 

20 

20. The system recited in claim 17, wherein the table 
file further comprises a logical location of the 
filesystem to be backed up. 

25 21. The system recited in claim 17, wherein the table 

file further comprises a logical location for at least one 
backup copy. 

22. The system recited in claim 17, wherein the table 
30 file further comprises a number of copies to be created. 

23. The system recited in claim 17, further comprising: 
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splitting means for splitting the filesystem on 
the basis of the filesystem being in use during 
backing up the filesystem. 

5 24. The system recited in claim 17, further comprising: 
locking means for locking the table file. 

25. The system recited in claim 24, further comprising: 
detecting means for detecting an error in 
10 backing up the filesystem; 

unlocking means for unlocking the table file; 

and 

editing means for editing the table file. 

15 26. The system recited in claim 17, further comprising: 
re-syncing means for re-syncing logical volumes 
servicing the filesystems. 



27. The system recited in claim 17, the building means 
20 for building a table file is an automated script. 

28. The system recited in claim 17, wherein the accessing 
means for accessing a table file is by an automated 
script . 

25 

29. The system recited in claim 17, wherein the backing 
means for backing up the filesystem is an automated 
script . 

30 30. The system recited in claim 25, wherein the unlocking 
means for unlocking the table file is an automated script. 
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31. The system recited in claim 26, wherein the 
re-syncing means for re-syncing logical volumes is an 
automated script. 

5 

32. The system recited in claim 23 , the splitting means 
for splitting the filesystem is an automated script. 

33. A data processing system implemented computer program 
10 product for automating a filesystem backup process, 

comprising: 

building instructions for building a table file, 
wherein the table file lists filesystems to be backed 
up; 

15 accessing instructions for accessing the table 

file; and 

backing instructions for backing up a filesystem 
listed in the table file. 



20 
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ABSTRACT OF THE DISCLOSURE 
5 ENHANCED BACKUP AND RECOVERY METHODOLOGY 

Initially, a table file is built which lists at least 
filesystems to be backed up. It also may list the type of 

10 backup techniques to be used for a specific filesystem, 
the filesystem' s logical location, and the number of 
copies to be made. The table file is checked for syntax 
and is then available for other routines. An automated 
script may be used for building the table, and then it may 

15 be manually edited if necessary. Other scripts may be 
invoked for backing up the filesystems listed in the 
script by accessing the table file. 
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#!/bin/ksh 

imtilffifttifmillfl llf tlll/tfiilMMIIIIIillMlil^ 
# 

# fscpbtab_unfock.ksh 



# Version 0.01 

# Runs various AFX commands to remove Jock on 

# the FSCPBK table file 

# Assembled by Carl Gusler 

# IBM Global Services 

# IBM Austin 

# cgusler@us.ibm.com 
# 

# (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 

# 



# 

# Copyright Information: Copyright IBM 1998 



# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program is an IBM Type II Deliverable as 

# described in the IBM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 . Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2. Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as ihey would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 



# 
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# This program is distributed on an "as is" basis, 

# no warranty is expressed or implied. 
# 

# 

U 

# 

# Description: Removes lock on /etc/fscpbktab talbe file. 

# A cleanup utility for problem times with FSCPBK scripts 

# Operational Environment: AIX V4 

# Input: 

# Output: 

# Return Value: 

# Comments: NOTE!!: This script is an excerpt of the fscpbk_back.ksh 

# script. If that script is edited, this one 

# should probably be edited to match. 
# 

# 

# 

# 

# Version History: None 
# 





# 

# Environmental Variables 
# 

# 

# Constants 

wire— * 

# Variables 

numeric_date=$(date +%m%d%y) 

text_date=$(date +%d%b%Y) 

typeset -i retur n_code 

typeset -i merge_return_code 

typeset -i retain_days=90 

typeset -i in_retain_days 

typeset -i copies 

typeset -i ncrement 

typeset -i mount_fs_test 

invoked_name=$0 

script_name=${invoked_name##*/} 

userJd=$(whoami) 

desc='ADSM Archive at '$text_date 

level -0 
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# Process Control Variables 
!Jlag=0 

LJIag=0 
rjlag=0 
d_flag=0 

# Files 

defaultJogjjir==/var/adm/scnptiogs 
defaultJogJile=$scriptjriame.$text_date 
default jDackup_device=/dev/rrritO. 1 
work_file1=/tmp/$script_name.$text_date t work1 
work_file2=/tnnp/$scnpt_name.$text_date.work2 
configjlle^/etc/fscpbktab 
audit_file=fetc/fscpbktab .audit 
]ock3'e = /var/locks/fscpbktab 

# 

# 

# Function: show_usage 

# Description: Displays command usage syntax and exits 

# Input: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 
# 

# 

show_usage () 
{ 

print -u2" 

print -u2 "Usage: fscpbktabjjnlock.ksh [-I directory] [-r days] " 
print -u2 ** 

print -u2 " -I directory Log output directory." 
print -u2 n Default is" $defaultJog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retatn_days 

print -u2 " 
exit 2 

} 

# 

# 

# Korn Shell Settings 
# 

# 

#set -o errexit # Turn on error trapping and error exit mode 
#set -o noclobber # Prevent overwriting of existing files 
#set -o noexec # Perform syntax checking without execution 
#set -o nolog # Prevents storing function defs in history file 
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#set -o xtrace # Turn on debug mode 

#- 

# 

# Main Routine 
# 

#_ 

# 

# Test for any passed paramaters, 
#if[$? !=0] 

#then 

# show_usage 
#fi 

# 

fog_dir=$default_Jog_dir 

# Parse Command Line Arguments tnto Variables 
while getopts l:r# c 

do 

case $c in 

I) # Set up the -I flag 
l_flag=1 

!og_dir=$OPTARG;; 
r) # Set up the -r flag 
r_f!ag=1 

injetain_days-$OPTARG;; 
:) show_usage;; 
\?) show usage;; 
esac 
done 

shift $((OPTIND-1)) 

# Deal with invocation errors 
if [[ Suserjd != root ]]; then 

showjjsage 

fi 



# Configure Logging 
if [[ $l__flag -eq 1 ]]; then 

fog_fiie=$in_iog__dir/$defaultjog_file 

mkdir -p $in_log_dir 2>/dev/nulf #Create new log directory 
else 

log_file=$defaultjog_dir/$defaultjog_file 

mkdir -p $defaultJog_dir 2>/dev/null # Create default log directory 



if [[ $r_flag -eq 1 ]]; then 

retain jjays=$in_retain_dsys 

fi 
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# Clear old logs 

find $log_dir-name "Sscriptjiame*" -mtime $retain_days -exec rm {> \; 

# Create new log file 

exec 3» $log_file # Open Jog file for writing 

print -U3 "\n=r===B=rr==s=a==s:====sa====s=s: S :s5aa===s====: 

print -u3 "= 

print -u3 "= Systems Management Transaction Log = M 

print -u3 "= =" 

print -u3 Created by script; 11 $script_name 

print -u3 1 - on system:" S(hostname) 

print -u3 1 - at ${date) 

print -u3 "= 

print -u3 M ===^=~====-===-===-==^==-==-=======^=-^========^= 

# Perform Work 

# Comments: NOTE!!: This script is an excerpt of the fscpbkjback.ksh 

# script. If that script is edited, this one 

# should probably be edited to match. 
# 

# Test for existing table file 
if [[ ! (r $config Jile) ]]; then 

print -u2 "Fatal Table error. Table file" SSconfigJile "not found." 
print hj3 "Fatal Table error. Table file" Sconfigjiie "not found." 
exec 3<&- 
exit 99 

fi 

# Unlock table file 

chrnod 644 Sconfig file 
rm $lock_file 2» $log_file 



exec 3<&- 



exit 0 



Figure 7E 

AT9-99-234 



#]/bin/ksh 

/////////////;/^ 

# fscpbktab_build.ksh 



# Version 0.33 

# Runs various AIX commands to build 

# table of filesystems to backup 

# Assembled by Carl Gusler 

# IBM Global Services 

# IBM Austin 

# cgusler@us.ibm.com 
# 

# {With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 



# 

# 

# Copyright information: Copyright IBM 1998 



# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program is an IBM Type II Deliverable as 

# described In the IBM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 . Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2. Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as they would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 
# 
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# This program is distributed on an "as is" basis, 

# no warranty is expressed or implied. 
# 

#. 

# 

# 

# Description: Builds table file for other scripts in FSCPBK packag 

# Operational Environment: AIX V4 and ADSM V3.1 

# Input: 

# Output: 

# Return Vaiue: 

# Comments: 
# 

# 

#. 

#, 

# 

# Version History: None 
# 

# . 

# . 

# 

# Environmental Variables 
# 

# 

# Constants 

wire— ' 

# Variables 

numeric_date-S(date +%Y%m%d%H%M) 

text_date=$(date +%d%b%Y) 

typeset -i return_code 

typeset -\ retain days=10 

typeset -i in_retain_days 

typeset -i copies 

typeset -i ncrement 

typeset -i return_code 

invoked_name=$0 

scriptjname=${invoked_name##*/} 

user_id=$(whoami) 



# Process Control Variables 

ljlag=0 

L_flag=0 

r_flag=0 
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# Files 

def au lt_log_d ir=/var/ad m/scriptl ogs 

default_log_file=$script_name.$text_date 

work_file1=/tmp/$script_name.$text_date.work1 

work_flle2=/tmp/$script_name J $text_date.work2 

config_file=/etc/fscpbktab 

lock_file=/var/locks/fscpbktab 



# 

# Function: show__usage 

# Description: Displays command usage syntax and exits 

# tnput: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 

#. 

show_usage () 

{ 

print -u2 " 

print -u2 "Usage: fscpbktabjbuild.ksh [-I directory] [-r days] " 
print -u2 M 

print -u2 " ~l directory Log output directory." 
print -u2 " Default is" Sdefaultjog^dir 

print -u2 " 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 

} 

#- 

# 

# Korn Shell Settings 
# 

#. 

#set -o errexit # Turn on error trapping and error exit mode 
#set -o noclobber # Prevent overwriting of existing files 
#set -o noexec # Perform syntax checking without execution 
#set -o nolog # Prevents storing function defs in history file 
#set -o xtrace # Turn on debug mode 

#. 

# 

# Main Routine 
# 

#. 
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# Test for any passed paramaters. 
#if [$*?!= 0 ] 

#then 

# show_usage 
#fi 

# 

log„dir=$defauit_Jog_dir 

# Parse Command Line Arguments into Variables 
while getopts a:l;p;r# c 

do 

case $c in 

I) # Set up the -I flag 
IJiag=1 

log_dir=$OPTARG;; 
r) # Set up the -r flag 
rjlag=1 

in_retain_days=$OPTARG,; 
:) showusage;; 
V?) showusage;; 
esac 
done 

shift $((OPTIND-1)) 

# Deal with invocation errors 
if {[ $iiser_id != root ]]; then 

show_usage 

fi 



# Configure Logging 
if [[ Sljlag -eq 1 ]]; then 

log_file=$in_log_dir/$defaultJog_fiie 

mkdir -p $in_log_dir 2>/dev/null #Create new log directory 
else 

iog_file™$default_log_dir/$defaultJog_file 

mkdir -p $defau!t_log_dir 2>/dev/null # Create default log directory 



if [[ $r_flag -eq 1 ]]; then 

retai n_days=$i n_retain_day s 

fi 

# Clear old logs 

find $log_dir -name "$script_name*" -mtime $retain_days -exec rm {} \; 

# Create new log fife 

exec 3» $log_file # Open log file for writing 
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1^ 



print -u3 "\n=— —==——==— =—=™====™™— 
print-u3"= 

print -u3 ' - Systems Management Transaction Log 
print -u3"^ 

print -u3 "= Created by script:'' $script_narne 
print -u3 "= on system:" $(hostname) 

print -u3 "= at :** $(date) 

print -u3 "= 

print -u3 *= ——™=™==— ====== --==========»: 

# Perform Work 

# Test for locked table file and exit 
if [[-f $lock_file]]; then 

print -u2 'Table file is currently in use and locked." 
print -u3 "Table file is currently in use and locked." 
exec 3<&- 
exit 96 

fi 

# Test for existing table file and save 
if [[ -r $config Jile ]]; then 

mv Sconfigjile $config_fite.old.$text_date 

fi 



# Create new tab file 

exec 4> $config Jile # Open table file for writing 

# prjn t -u4 ,1 #: 1f $(date V'%Y%m%d%H%M"):"====— =======—== 

print -u4 M #===~=========-===============~==== : -=- : = = 

print -u4"# 

print -u4 "# Filesystem Backup Selection Table file 
print -u4 "# 

print -u4 "# Format: bc:pfs:plv:c:afs:alv 
print -u4 "# 

print -u4 "# or - ' 

print -u4 w # = M 

print -u4 "# be (Backup Control) =" 

print -u4 rt # xb -> AIX Backup {Level 0 AIX FS Backup) 

print -u4 "# no -> No Backup (Skip filesystem) 

print -u4 "# as -> ADSM Selective Backup =" 

print -u4 "# ai -> ADSM Incremental Backup 

print -u4 "# aa -> ADSM Archive 

print ~u4 "# 

print -u4 M # = " 
print -u4 "# pfs (Primary Filesystem) - n 

print -u4 "# The full path of standard filesystem 

print -u4 ,r # 

print -u4 M # piv (Primary Logical Volume) 
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print -u4 M # The AIX LV name of the logical volume 

print -u4 "# containing the primary filesystem 
print -u4 "# 

print -u4"# c (Copies) 

print -u4 "# The number of AIX LVM copies of the 

print -u4 M # logical volume containing primary 

print -u4 "# filesystem. 

print -u4 "# Must be numeric 1 ,2, or 3. =" 
print -u4 "# 

print -u4 "# afs {Alternate Filesystem) 

print -u4 "# The full path of mirror copy filesystem = w 

print -u4 "# Must be unique!!!!! - ' 

print -u4 "# 

print -u4 "# alv (Alternate Logical Volume) 

print -u4 "# The AIX LV name of the logical volume - ' 

print -u4 M # containing the alternate filesystem 

print -u4"# Must be unique!!!!! 

print -u4 "# 

print -u4 "# Example for a mirrored home filesystem to be 

print -u4 "# backed up using AIX backup command: ™" 

print -u4 "# 

print -u4 "# xb:/home:hd1 :2:/alt/home:alt!vh 

print -u4 "# n 

print -U4 '^=:===:==5:=;=================s========== : ==========- = ===-=--=== 



print -u3 H \nStarting Build of Filesystem Backup Table File-" 

print -u3 "\nTable lines are:" 

ncrement=0 

return_code=0 

for fsjine in S(lsfs -ac | grep -v *■#) 
do 

if [[ $(print $fs_line | cut -f 3 -d : ) = jfe ]]; then 
fs_prime=$(print $fs_iine | cut -f 1 -d :) 
iv_prime=$(print $fs_line j cut -f 2 -d : [ cut -c 6-) 

# What if LV in /etc/filesystems does not actually exist? 

# LSLV below croaks 

copies=$(lslv $lv_prime | grep COPIES | awk '{ print $2 }') 
if [[ $copies -eq 1 ]];then 

tab_line=xb:$fs_prime:$lv_prime:$copies 

eEif [[ $copies -eq 2 J]; then 

tabJine=xb:$fs_prime:$lvjprime:$copies:/alt/fs$ncrement:altlv$ncrement 

((ncrement=$ncrement+1 )) 

eiif [{ Scopies -eq 3 ]]; then 

tabJine=xb:$fs_prime:$lv_prime:$copies:/alt/fs$ncrement:altlv$ncrement 

((ncrement=$ncrement+1 )) 
else 
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tab_line=xb:$fs_prime:$Jv - prime:1 
print -u2 "Script execution error: AIX islv output confusion, 
print -u3 "Script execution error: AIX Islv output confusion. 
((return_code=$retum_code+1 )) 

fi 

print -u3 $tabjine 
print -u4 Stabjine 
fi 

done 



exec 3<&- 
exec 4<&- 

# Test for fit esystem parsing problems 
if [[ $return_code -ne 0 ]]; then 
exit 10 

fi 

exit 0 
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#!/bin/ksh 

//////////////#/^ 

# 

# fscpbkiab_check.ksh 



# Version 0.33 

# Runs various AIX commands to check filesystem 

# table file 

# Assembled by Carl Guster 

# IBM Global Services 

# IBM Austin 

# cgusler@us.ibm.com 
# 

# (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 

# 



#- 

# 

# Copyright Information: Copyright IBM 1998 



# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program is an IBM Type II Deliverable as 

# described in the IBM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 . Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2. Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as they would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 
# 
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# This program is distributed on an "as is" basis, 

# no warranty is expressed or implied, 
# 

# . 

#. 

# 

# Description: Performs syntax check on FSCPBK table fife, 

# Part of FSCPBK package of scripts. 

# Operational Environment: AIX V4 and ADSM V3.1 

# Input: 

# Output: 

# Return Value: 

# Comments: 
# 

# 

# 

# 

# Version History: None 
# 

# 

#- 

# 

# Environmental Variables 
# 

# 

# Constants 

wire='= 1 

# Variables 

numeric_date=$(date +%m%d%y) 

text_date=$(date +%d%b%Y) 

typeset -i return_code 

typeset -i retain_days=90 

typeset -i in j*etainjjays 

typeset -i copies 

typeset -i Jv_copies 

typeset h lv_disks 

typeset -i ncrement 

typeset -i return_code 

lnvoked_name=$0 

script jiame=${invoked_name##*/} 

userjd=$(whoami) 
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# Process Control Variables 
l_flag=0 

L_flag=0 
r_flag=0 

# Files 

default_log_dir=/var/adm/scriptlogs 

defaultJog_file=$script_name.$text_date 

work_fi!e1 =/tmp/$script_name .$text_date.work1 

work_file2=/tmp/$script_name.$text_date,work2 

config_file=/etc/fscpbktab 

audit_file=/etc/fscpbktab.audit 

lock_file=/var/locks/fscpbktab 

# „ 

# 

# Function: showjjsage 

# Description: Displays command usage syntax and exits 

# Input: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 
# 

#. 

show_usage () 

{ 

print -u2 " 

print -u2 "Usage: fscpbktab_check.ksh [-I directory] [-r days] 11 
print -u2 " 

print -u2 " -I directory Log output directory. 11 
print -u2 " Default is w $default_tog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 

} 

#- 

# 

# Korn Shell Settings 
# 

#. 

#set -o errexit # Turn on error trapping and error exit mode 
#set -o noclobber # Prevent overwriting of existing files 
#set -o noexec # Perform syntax checking without execution 
#set -o nolog # Prevents storing function defs in history file 
#set -o xtrace # Turn on debug mode 
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# 

# Main Routine 
# 

#- 

# 

# Test for any passed paramaters. 
#if [ $? != 0 ] 

#then 

# showjjsage 
#fi 

# 

log_dir=$default_log_dir 

# Parse Command Line Arguments into Variables 
while getopts a:l:p:r# c 

do 

case $c in 

I) # Set up the -I flag 
l_flag=1 

log_dir-$OPTARG;; 
r) # Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) showjjsage;; 
\?) show_usage;; 
esac 
done 

shift ${{OPTIND-1)) 

# Deal with invocation errors 



# Configure Logging 

if [[ Jljlag -eq 1 ]]; then 

log_file=$in_log_dir/$defaultJog_file 

rnkdir -p $in_log_dir 2>/dev/null #Create new log directory 
else 

logJile=$defaultJog_dir/$defaiiltJog_fiie 

rnkdir -p SdefeultJoQLdir 2>/dev/null # Create default log directory 

fi 

if [[ $r Jlag -eq 1 ]]; then 

retain_days=$in_retain_days 

ft 

# Clear old logs 

find $log_dir -name "$script_name* H -mtime $retain_days -exec rm Q \; 

# Create new log file 

exec 3» $log_file # Open log file for writing 
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Print "U3 "\n===S=SBSSSSS = ==SSSS3SS5== ======== = ==== = ===========S=== = ====- 

print-u3"= 

print -u3 1 - Systems Management Transaction Log =" 
print -u3"= 

print -u3 "= Created by script:" Sscriptjiame 

print -u3 "= on system:" $(hostname) 

print -u3 "= at : n $(date) 

print -u3 "= ~ M 

# Perform Work 

# Test for existing table file 
if [[ ! (-r SconfigJ ie) ]]; then 

print -u2 Table error: Tabie file" $config_file "does not exist." 
print -u3 "Tabie error: Tabie file" $config_file "does not exist" 
exit 99 

fi 

# Test for locked tabie file 
if [[-f $lock_file]]; then 

print -u2 "Warning: Tabie file is currently in use and locked." 
print -u3 "Warning: Table file is currently in use and locked." 



# Perform Syntax Checking on Table File 

return_code=0 

ncrement=1 

for fsjine in $(cat $config_file | grep -v A #) 
do 

action =$(print $fsjine | cut -f 1 -d :) 
case $action in 

xb) : ;; 

no) : ;; 

as) : ;; 

ai) : ;; 

aa) : ;; 

*) print -u2 "Table error: Action" Saction "not valid." 
print -u3 'Table error: Action" Saction "not valid." 
((return_code=$return_code+1 ));; 

esac 

fs_pnme=$(print $fsjine | cut -f 2 -d :} 

Ivj3rime=$(print $fsjine | cut -f 3 -d :) 

if [[ $(lsfs -c $fs__prime | grep $lv_prime | wc -I) -ne 1 ]j; then 

print -u2 "Table error: Filesystem" $fs_prime "does not reside in LV" $lv_prime 
print -u3 "Table error: Filesystem" $fs_prime "does not reside in LV" $ivjDrime 
((return_code=$return_code+1 )) 

fi 

copies=S(print $fsjine | cut -f 4 -d :) 
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if [[ ($copies -ge 1 ) && ($copies -le 3) ]]; then 
if [[ (Scopies -gt 1 ) && ($copies -le 3) ]]; then 
fs_alt=$(print Sfsjine j cut -f 5 -d :) 
*v_alt=$(print $fsjine | cut -f 6 -d ;) 
if [[ ${lsfs -c $fs_alt 2>/dev/null | wc -I) -ne 0 ]]; then 

print -u2 'Table error; Filesystem" $fs_alt "already exists." 
print -u3 "Table error; Filesystem" $fs_alt "already exists." 
{(return_code=$return_code+1 )) 

fi 

if [[ ${islv $iv„ait 2>/dev/null | wc -I) -ne 0 ]]; then 
print -u2 "Table error: LV" $fv_alt "already exists." 
print -u3 "Table error: LV" $lv_alt "already exists," 
((return_code=$retum__code+1 )) 

fi 

strictness_flag=${lslv $lv_prime | grep "EACH LP COPY ON" | grep yes | wc -I) 

if [[ $strictness_flag -eq 0 ]]; then 

print -u2 "LVM Warning: Mirror strictness not set for LV H Slvjsrime 
print -u3 "LVM Warning: Mirror strictness not set for LV" $lv_prime 

fi 

lv_copies=$(!slv $Iv_jprime | grep COPIES | awk '{ print $2 }') 

if [[ $lv_copies -ne Scopies ]]; then 

print -u2 ,l LVM Warning; LV mirroring does not match table for LV* $lv_prime 
print -u3 "LVM Warning: LV mirroring does not match table for LV" $lv_prirne 

fi 

lv_disks=$(lsiv -I $lv_prime | grep hdisk j wc -I) 

if [[ $lv_disks -ne $!v_copies ]]; then 

print -u2 "LVM Warning: Broad LV mirroring distribution for LV" $lv_prime 
print -u3 "LVM Warning: Broad LV mirroring distribution for LV" $lv_prime 

fi 

fi 

else 

print -u2 "Table error: Invalid number of LV copies for LV" $iv_prime 
print -u3 "Table error: Invalid number of LV copies for LV" $lv_prime 
((return_code=$return_code+1 )) 

fi 

done 

if [[ ($retum_code -ne 0) l];then 

return 98 
else 

print -u2 "Table file parses okay." 
exec 4> $audit_file # Open audit file for writing 
current_Y=${date +%Y) 
current_m~$(date +%m) 
current_d=$(date +%d) 
current_H=$(date +%H) 
current_M=$(date +%M) 
# print -u4 $current_Y $currentjn $current_d $current_H $current_M 
print -u4 $current_Y$current_m$current_dScurrent_H$current_M 
exec 4<&- 
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fi 

# Table file format 

# Format: bc:pfs:plv:c:afs;alv 

# xb:/home:hd1 :2:/alt/home:/altivh 



exec 3<&- 
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#!/bin/ksh 

###################### ##^ 
# 

# fscpb_sync.ksh 



# Version 0.02 

# Runs various AiX commands to synchronize ail 

# stale logical volumes 

# Assembled by Carl Gusler 

# IBM Global Services 

# IBM Austin 

# cgusier@us.ibm,com 
# 

# (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 



# 

# Copyright Information: Copyright IBM 1998 



# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program Is an IBM Type II Deliverable as 

# described in the IBM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains aif rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 . Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2. Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as they would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 
# 
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# This program is distributed on an "as is" basis, 

# no warranty is expressed or implied. 
# 

# 

# 

# 

# Description: Synchronizes all logical volumes with stale partitions 

# Part of FSCPBK package. 

# Operational Environment: AIX V4 

# Input: 

# Output: 

# Return Value: 

# Comments: 
# 

# 

# m 

#. 

# 

# Version History: None 
# 

#. . 



#. 

# 

# Environmental Variables 
# 

# 

# Constants 

bar= , ======================= 

* 

wire-= 

# Variables 

numeric__date=$(date +%m%d%y) 
text_date=$(date +%d%b%Y) 
typeset -i return_code 
typeset -i retain_days=90 
typeset -i in jretain_days 
typeset -i copies 
typeset -i ncrement 
typeset -i return_code 
invoked_name=$0 
scriptjiame=${invoked_name##*/} 
user jd :=$(whoami) 
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# Process Control Variables 
i_flag=0 

L_flag=0 
r_flag=0 

# Files 

default_log_dir=/var/adfn/scriptlogs 
defa u tt_!og_f ile=$script_name . $texi_d ate 
workjfi I e 1 =/tmp/$script_name . $text_date .work 1 
work__file2=/tmp/$script_name.$text_date.work2 
config_file=/etc/fscpbktab 

# 

# 

# Function: show_usage 

# Description: Displays command usage syntax and exits 

# Input: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 
# 

# 

showjjsage {) 
{ 

print -u2 " 

print -u2 "Usage: fscpbk_sync.ksh [-I directory] [-r days] * 
print -u2 " 

print -u2 " -I directory Log output directory." 
print -u2 " Default is" $default_log_dir 

print -u2 " 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 

} 

# 

# 

# Korn Shell Settings 
# 

# 

#set -o errexit # Turn on error trapping and error exit mode 
#set -o noclobber # Prevent overwriting of existing files 
#set -o noexec # Perform syntax checking without execution 
#set -o nolog # Prevents storing function defs in history file 
#set -o xtrace # Turn on debug mode 

# 

# 
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# Main Routine 
# 

#_ 

# 

# Test for any passed paramaters. 
#if[$? 1=0] 

#then 

# showusage 
#fi 

# 

log_dir=$defauit_log_dir 

# Parse Command Line Arguments into Variables 
while getopts l;r# c 

do 

case $c in 

i) # Set up the -I flag 
ijlag-1 

log__dir=$OPTARG;; 
r) # Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) showjjsage;; 
\?) show_usage;; 
esac 
done 

shift $((OPTIND-1)) 

# Deal with invocation errors 
if [[ $user_id N root]]; then 

show_usage 

fi 



# Configure Logging 
if [[ $i_flag -eq 1 ]]; then 

log_fHe=$inJog_dir/$default_iog_fiie 

mkdir -p $inJog_dir 2>/dev/null #Create new log directory 
else 

log_file=$defaultJog_dir/$defaultJog_file 

mkdir -p $defauit_log dir 2>/dev/nuti # Create default log directory 



if [[ $r_flag -eq 1 ]]; then 

retain_days=$in_jetain__days 

fi 

# Clear old logs 

find $log_dir -name "$script_name* n -mtime $retain_days -exec rm {} \; 



fi 
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# Create new log file 

exec 3» $log Jlle # Open log file for writing 

print -u3 ^n~==~==~==«~===~ s =====-~==~=- ss — =s:: 
print -u3 "= 

print -u3 H = Systems Management Transaction Log 
print -u3 "= 

print ~u3 "= Created by script:" $script_name 
print -u3 "= on system: 11 $(hostname) 

print -u3 "= at $(date) 

print -u3 "= =" 
print -u3 "====================================—==== 

# Perform Work 

# Test for any stale logical volumes within active volume groups 

print -u1 "Starting syncvg operation. This make take several minutes." 
return_code=0 

for logical_vofume in $(lsvg -o | Isvg -il | grep stale | awk '{ print $1 }' ) 
do 

print -u3 " Starting syncvg operation on LV" $iogicai_voiume 
print -u1 "Starting syncvg operation on LV" Slogical_volume 



print -u3 " Completed syncvg operation on LV* $iogicai_volume 
print -u3 " Cumulated return code is" $return_code 
done 

exec 3<&- 



syncvg -I $logical_volume 
{(return_code=$return_code+$?» 



if [[ ($return_code -ne 0) ]];then 
return 50 

fi 



m 



exitO 
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#!/bin/ksh 
# 

# fscpb_select.ksh 

# Version 0.34 

# Runs various AiX commands to select and split 

# filesystems for backup 

# Assembled by Cad Gusler 

# IBM Global Services 

# IBM Austin 

# cgusler@usjbm.corn 
# 

# (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 

# 



# 

# Copyright Information: Copyright IBM 1998 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program is an IBM Type II Deliverable as 

# described in the IBM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 , Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2, Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as they would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 
# 
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# This program is distributed on an "as is" basis, 

# no warranty is expressed or implied, 
# 

# 

# 

# 

# Description: Selects and splits filesystems for backup. 

# Part of FSCPBK package of scripts, 

# Operational Environment; AIX V4 

# Input: 

# Output: 

# Return Value: 

# Comments: 
# 

# 

#_ 

#_ 

# 

# Version History: None 
# 

#. 

# 

# Environmental Variables 
# 

# 

# Constants 

bar=*=====— ============== «ss«============== 

wire-- ' 

# Variables 

numeric_date=$(date +%m%d%y) 
text_date=$(date +%d%b%Y) 
typeset -I return_code 
typeset -i retain__days=9G 
typeset -i in_retain_days 
typeset -i copies 
typeset -i new_copies 
typeset -i ncrernent 
typeset -i ntest 
typeset -i return_code 
#typeset -i edit__year 
#typeset -i editjrionth 
#typeset -i edit_day 
#typeset -i editjiour 
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#typeset -i editjninute 

typeset -i edit__stamp 

typeset -i audit_year 

typeset -i audit_rnonth 

typeset -i audit_day 

typeset -i auditjiour 

typeset -i audit_mtnute 

typeset -i audit_stamp 

invokedjiame=$0 

scripLname=${invoked_nanne##*/} 

user_id=$(whoami) 



# Process Control Variables 
ljlag=0 

L_flag=0 
r_flag=0 
o_flag=0 

# Files 

default_iog_dir=/var/adm/scriptlogs 

defaultJog_fiIe=$script_name.$text_date 

work_file1=/tmp/$script_name.$text_date.work1 

work_file2=/tmp/$script_name.$text_date.work2 

config_file=/etc/fscpbktab 

audit_fiie=/etc/fscpbktab.audit 

lock_file=/var/locks/fscpbktab 

# 

# 

# Function: show_usage 

# Description: Displays command usage syntax and exits 

# Input: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 
# 

# 

showjjsage () 
{ 

print -u2 " 

print -u2 "Usage: fscpbk_select.ksh -o [-I directory] |>r days] " 
print -u2 H 

print -u2 " -o Override active volume protection." 

print -u2 " WARNING!!: Data integrity risk." 

print -u2 " IBM not responsible for" 

print -u2 " loss of data or integrity" 

print -u2 " if override used to split" 
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print -u2 " a mirrored filesystem" 

print -u2 " that is mounted!" 

print -u2 " 

print -u2 " -I directory Log output directory ." 
print -u2 " Default is H $defaultJog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 



# 

# Korn Shell Settings 
# 

#. 



#set -o errexit # Turn on error trapping and error exit mode 
#set -o noclobber # Prevent overwriting of existing files 
#set -o noexec # Perform syntax checking without execution 

#set -o nolog # Prevents storing function defs in history file 

#set -o xtrace # Turn on debug mode 



#. 

# 

# Main Routine 
# 

#- 

# 

# Test for any passed paramaters. 
#if [ $? !- 0 ] 

#then 

# show_usage 
#fi 

# 

log_dir=$defaultJog_dir 

# Parse Command Line Arguments into Variables 
while getopts ol:r# c 

do 

case $c in 

0) # Set up the -o flag 
o_flag=1;; 

1) #Set up the -I flag 
l_fiag=1 

log_dir=$OPTARG;; 
r) # Set up the -r flag 
r__flag=1 

in_retain_days-$OPTARG; ; 
:) show_usage;; 
\?) show_usage;; 
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esac 
done 

shift $«OPTIND-1)) 

# Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 

if [[$oJlag -ne 1 ]]; then 
showusage 

fi 



# Configure Logging 

if [[ $! Jiag -eq 1 ]]; then 

log_fiie=$in_log_dir/$defaultJog_file 

mkdir -p $inJog_dir 2>/dev/nuli #Create new log directory 
else 

log_fiie=$default_log_dir/$defauitJog_file 

mkdir -p $default_Jog_dir 2>/dev/nulf # Create default log directory 

fi 

if [[ $r__fiag -eq 1 ]]; then 

reta in_day s=$i n_retain_days 

fi 

# Clear old logs 

find $iog_dir -name M $script_name*" -mtime $retain_days -exec rm {} \; 

# Create new log file 

exec 3» $log_file # Open log file for writing 
print -u3 

print -u3 "= Systems Management Transaction Log =" 
print -u3 "= 

print -u3 M = Created by script:" $script_name 
print -u3 "= on system:" $(hostname) 

print -u3 "= at $(date> 

print -u3"= 

print -u3 "-=====--=====================—=========== == =—==" 

# Perform Work 

# Test for existing table file 
if [[ ! (-r $config_file) ]]; then 

print -u2 "Fatal Table error. Table file" $conftg Jile "not found." 
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print -u3 Tata! Table error. Table file" Sconfigjile "not founds 
exec 3<&- 
exit 99 

fr 

# Test for existing table audit file 
if [[I (-r $auditjile) ]]; then 

print -u2 "Fatal Table error Table file check program must be run 
print -u3 "Fatal Table error. Table audit file" Sauditjile "not found 
exec 3<&- 
exit 97 

fi 

# Test for table file audit indicating syntax check since last edit 



current_Y=$(date +%Y) 

audit_stamp=$( head -1 Sauditjile | awk '{ print $1 }') 

# Check for colon and thus time instead of year on file datestarnp 
ntest=$(ls -I Sconfigjile j awk '{ print $8 }' | grep : | wc -I) 
if [[ Sntest -eq 1 ]]; then 

edit_year=$current_Y 
else 

edit_year=$(ls -I $config_file | awk "{ print $8 }') 

fi 



edit__month_text=${ls -I Sconfigjile | awk '{ print $6 }'} 
edit_day=$(ls -I Sconfigjile | awk '{ print $7 }*) 
edltjiaup=$(ls -I Sconfigjile | awk '{ print $8 }' | cut -f 1 -d :) 
edit_minute=$(is -I Sconfigjile | awk '{ print $8 }' | cut -f 2 -d :) 

# Determine month number from month name 

case $edit_month Jext in 

Jan) edit_month=01 ;; 

Feb) edit_month=02;; 

Mar) edit_month=03;; 

Apr) edit_month=04; ; 

May) edit_month=05;; 

Jun) editjmonth=06;; 

Jul) edit_month=07;; 

Aug) edit_month=08;; 

Sep) edit_month=09;; 

Oct) edit_month=10;; 

Nov) edit_month=1 1 ;; 

Dec) edit_month=1 2;; 
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*) print -u2 "Fatal Table error. Table file date read error," 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 

esac 



edit_stamp=$edit^ear$ediL^onth$edit_day$edit_hour^edit_mirtute 

# Test for table file audited since last editing 
if [[ $audit_stamp -le $edit_stamp ]]; then 

print -u2 "Fatal Table error. Table file edited since last checked." 
print -u3 "Fatal Table error. Table file edited since last checked." 
exec 3<&- 
exit 97 

fi 

# Test for locked table file and exit 
if {[-f$lockJile]]; then 

print -u2 "Table file is currently in use and locked." 
print -u3 "Table file is currently in use and locked," 
exec 3<&- 
exit 96 

fi 



# Table file format 

# Format: bc:pfs:plv:c:afs:alv = 

# xb:/home:hd1 :2:/alt/home:/altlvh 

# Create lock on table file to indicate that table is in use. 
touch Slockfiie 

chmod 000 $config_file 



# Increment through table file and split mirrored filesystems 

return_code-0 

ncrement=0 

for fsjine in $(cat $config_file | grep -v A #) 
do 

action=$(print $fsjine | cut -f 1 -d ;) 
copies=S(print $fs_line | cut -f 4 -d :) 
if [[ (Scopies -gt 1 ) && ($action != no) ]]; then 

fs _prime=$(print $fs_iine | cut -f 2 -d :) 

lv_prime=$(print $fsjine | cut »f 3 -d :) 

fs_alt=${print $fsjine | cut -f 5 -d :) 

!v_aft=$(print Sfsjine j cut -f 6 -d :) 

tag_fiie=$fs_prime/.fscpbk_$lv_prime 

exec 4> $tag_file # Open tag file for overwriting 
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print -U4 ^====~=============t=s:==========:========== = 

print -u4 n #= =" 

print -u4 "#= Tag file used by IBM FSCPBK Utility. 

print ~u4 M #= DO NOT DELETE THIS FILE!!!!!!!!!"!! 

print -u4 "#= =" 

print -u4 Files in this directory and subdirectories below 

print *u4 "#= were originally contained within filesystem; =" 

print -u4 "#= H $fs_prime 

print -u4 "#= =" 

print -u4 "#==================™=====:==-====:===== 5 ========= 

exec 4<&- 

({new_copies=$copies-1 )) 
sync;sync 

$pNt_fs_copy.ksh -f $fs_prime -n $fs_alt -y $lv_alt -c $new_copies -o 
((return_code-$return_code+$?)) 

print -u3 Saction $fs_prime $lv_prime Scopies $fs_alt $lv_alt 

fi 

done 



exec 3<&- 

if [[ ($return_code -ne 0) ]];then 

exit 10 
else 

exit 0 

fi 
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#!/bin/ksh 

#############^^ 
# 

#fscpb_back.ksh 



# Version 0.34 

# Runs various AIX commands to backup and merge 

# filesystems 

# Assembled by Carl Gusler 

# IBM Global Services 

# IBM Austin 

# cgusler@us . ibm . com 
# 

# (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 

# 



iitiitiituiinfiuiitiiiiiifitiiiitifttiittimm 

# _ 

# 

# Copyright Information: Copyright IBM 1998 



# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program is an IBM Type li Deliverable as 

# described in the IBM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 . Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2. Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as they would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 
# 
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# This program is distributed on an "as is" basis, 

# no warranty is expressed or implied. 
# 

#. 

#. 

# 

# Description: Provides capability to perform split mirror backups. 

# Part of FSCPBK package. 

# Operational Environment: AIX V4 and ADSM V3.1 

# Input: 

# Output: 

# Return Value: 

# Comments: 
# 

# 

# 

# 

# 

# Version History: None 
# 

# 

#. 

# 

# Environmental Variables 
# 

#_ 

# Constants 

bar='==============================~==="== == == === 

i 

# Variables 

numeric_date^$(date +%m%d%y) 

text_date=$(date +%d%b%Y) 

typeset -i returncode 

typeset -i merge_return_code 

typeset -i retain_days=90 

typeset -i in_retain_days 

typeset -i copies 

typeset -i ncrement 

typeset ~i mount__fs_test 

invoked_name-$0 

script_name-${invoked_name##*/} 

userjd=${whoami) 

desc-'ADSM Archive at *$text_date 

level=0 

use_tape=0 
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# Process Control Variables 
l_flag=G 

L_fiag=0 
r_flag=0 
d_flag=0 

# Files 

defauit_iog_dir=/var/adm/scriptlogs 

defauttJog_file-$scriptjr»ame.$text_date 

default_backup_device=/dev/rmt0.1 

workjile 1 =/tm p/$script_name .$text__date .work 1 

work_ftle2=/tmp/$script_name.$text_date.worl<2 

config_file=/etc/fscpbktab 

audiMile^/etc/fscpbktab.audit 

lock_file=/var/locks/fscpbktab 



- 

# 

# Function: show_usage 

# Description: Displays command usage syntax and exits 

# Input: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 
# 

#- 

showjjsage () 
{ 

print -u2 " 

print -u2 "Usage: fscpbk_back.ksh [-d device] [-I directory} [-r days] 
print -u2 " 

print -u2 " -d device Backup output device." 

print -u2 " Default is" $default_backup_device 

print -u2 " 

print -u2 * -I directory Log output directory. 1 ' 
print -u2 " Default is" $defaultJog_dir 

print -u2 tt 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 

} 
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#. 

# 

# Korn Shell Settings 
# 

# 

#set -o errexit # Turn on error trapping and error exit mode 
#set -o nociobber # Prevent overwriting of existing files 
#set -o noexec # Perform syntax checking without execution 
#set -o nolog # Prevents storing function ctefs in history file 
#set -o xtrace # Turn on debug mode 

# 

# 

# Main Routine 
# 

# 

# 

# Test for any passed paramaters. 
#if [ $? != 0 ] 

#then 

# showusage 
#fi 

# 

log_dir=$defaultjog_dir 

# Parse Command Line Arguments into Variables 
while getopts d:l:r# c 

do 

case $c in 

d) # Set up the -d flag 
djlag=1 

in_backup_device=$OPTARG ;; 
I) # Set up the -i flag 
!_flag=1 

log_dir=$OPTARG;; 
r) # Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esac 
done 

shift $((OPTIND-1)) 

# Deal with invocation errors 
if [[ $userjd i= root ]]; then 

showusage 

fi 

# Locate target file or device for backup images 
if [f $d Jag -eq 1 ]]; then 
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if [[ $in J3ackup_device = /dev/rmt[0-9]* ]]; then # Test rf target is tape drive 
use_tape=1 

if [[ -c $in J>ackup_device ]]; then # Test if tape drive exists 

device =$in_backup_device 
else 

print -u2 "\nNonexistent tape drive" $in_backup_jdevice 
show_usage 

fi 

else # Should we check to make sure some disk device not chosen? 
de vice=$ in_backup_de vice 



device=$default_backup_device 

fi 



# Configure Logging 

if [[ $l_flag -eq 1 }]; then 

log_file=$in_log_dir/$defaultjog_file 

mkdir -p $in_log_dir 2>/dev/nuil #Create new log directory 
else 

log_file=$defauitJog_dir/$default_logJile 

mkdir -p $defau!tJog_dir 2>/dev/nuil # Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 

retain_days=$in_retain__days 

fi 

# Clear old logs 

find $iog_dir -name M $script_name*" -mtime $retain_days -exec rm 0 V 

# Create new log file 

exec 3» $iog_file # Open log file for writing 
print -u3 "= 

print -u3 "= Systems Management Transaction Log 
print -u3 =" 
print -u3 "= Created by script:" $script_name 
print -u3 "= on system:" ${hostname) 
print -u3 "= at :« $(date) 
print -u3 "= =" 



fi 
else 
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# Perform Work 

# Test for existing table file 
if [[ ! (-r $config Jile) ]]; then 

print -u2 "Fatal Table error. Table file" $config jfile "not found- 
print -u3 "Fatal Table error. Table file" Sconfigjile "not found/' 
exec 3<&- 
exit 99 

fi 

# Test for existing table audit file 
if [[ ! (-r Sauditjile) ]]; then 

print -u2 "Fatal Table error. Table fiie check program must be run. 
print -u3 "Fatai Table error. Table audit file" $audit_file "not found, 
exec 3<&- 
exit 97 

fi 

# Test for table file audit indicating syntax check since last edit 



current_Y=$(date +%Y) 

audit_stamp=$( head -1 $audit_file | awk '{ print $1 }') 

# Check for colon and thus time instead of year on file datestamp 
ntest=${ls -I $config Jite | awk '{ print $8 }' [ grep : | wc -I) 
if [[ Sntest-eq 1 ]]; then 

ed it_y ear= $cu rre nt_Y 
else 

edit_year=S(ls -I $config_file | awk '{ print $8 }') 

fi 



edrtjnonth Jext=$(ls -i Sconfigjile | awk '{ print $6 }') 
edit_day=$(ls -I $config_file | awk '{ print $7 }') 
edit_hour=$(ls -I Sconfigjile | awk *{ print $8 }' | cut -f 1 -d :) 
edit_minute=$(ls -i $config Jile | awk '{ print $8 }' | cut -f 2 -d :) 

# Determine month number from month name 
case $edit_month_text in 
Jan) edit_month-01 ;; 
Feb) edit_month=02;; 
Mar) edit_month=03;; 
Apr) ed it_month=04; ; 
May) edit_j7ionth=05;; 
Jun) edit_month=06;; 



Jul} edit_month=07;; 
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Aug) edit_month=08;; 
Sep) editjmonth=09;; 
Oct) ed it_month =10;; 
Nov) editjrnonth=1 1;; 
D ec) ed it_month= 12;; 

*) print -u2 "Fatal Table error. Table file date read error." 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 

esac 



edit_stamp=$edit^ear$edit_month$edit__day$edit_hour$edit__minute 

# Test for table file audited since last editing 
if [[ $audit_stamp -le $edit_stamp ]]; then 

print -u2 "Fatal Table error. Table file edited since last checked." 

print -u3 "Fatal Table error. Table file edited since last checked." 

exec 3<&- 

exit 97 

fi 



# Table file format 

# Format: bc:pfs:plv c:afs alv 

# xb:/home:hd1 :2:/alt/home:/altivh 



ncrement=0 
return^ode^O 

# Cycle through filesystems and mount unmounted ones 

for fsjine in $(cat $configJile | grep -v A #) 

do 

action=${print Sfsjine | cut -f 1 -d :) 
fs_prime=$(print $fsjine | cut -f 2 -d :) 
!vjp>rime=${print $fsjine | cut -f 3 -d :) 
copies=${print $fs_line | cut -f 4 -d :) 
target_fs =$fs__prime 
if [[ $action != no ]]; then 
if [[ Scopies -gt 1 ]]; then 

target_fs=$(print $fs_line | cut -f 5 -d :) 

fi 
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# Check to see if target filesystem is mounted 

mount_fe_test=$(mount | grep "$target__fs " | wc -I) 

# If not mounted, mount as readonly for backups 

if [[ $mount_fs_test -ne 1 ]]; then 

mount -o ro $target_fs »$logJile 2»$log_file 
return_code=$? 

# Test for unsuccessful readonly filesystem mount 

if [[ $return_code -ne 0 ]]; then 

# If still unsuccessful, then perform filesystem check (presume dirty superbiock) 

print ~u3 "Performing fsck on niesystem" $target_fs 
fsck -p $targetjs »$log_file 2»$log_file 
mount -o ro $target_fs 2»$log Jile 

fi 

fi 

fi 

done 

return_code=Q 
merge_return_code=0 



# Put Table File at start of tape to serve as tape TOC 
if [[ $usejape -eq 1 ]]; then 
cp /etc/fscpbktab . 

echo "Jfscpbktab" | backup -ipqf Sdevice 
rm ./fscpbktab 

fi 



# Cycle through filesystems and perform backups and merges 
forfsjine in $(cat Sconfigjite | grep -v A #) 

do 

action-$(print Sfsjine | cut -f 1 -d :) 
fs _prime=$(print $fs_line | cut -f 2 -d :) 
lv_prime=$(print $f$Jine | cut -f 3 -d :) 
copies=$(print $fsjine j cut -f 4 -d ;) 
target_fs =$fs_pri me 

print -u3 $action $fs_prime $lv_prime Scopies 
if [[ Saction != no ]]; then 

# Select to backup alternate mirror fs if mirroring on 
if [[ $copies -gt 1 ]]; then 

fs_alt=$(print $fs_ltne | cut -f 5 -d :} 
lv_alt=${print Sfsjine | cut -f 6 -d :) 
target Js=$fs__alt 

print -u3 $action $fs_prime $lv_prime Scopies $fs_alt $iv_alt 

fj 
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mount JsJest=$(mount | grep "Stargetjs " 1 wc -I) 

# Test for filesystem STILL not mounted 
if [[ Smountjs Jest -eq 1 ]]; then 

case faction in 

no) # Perform no backup action 

print -u3 "No backup performed on filesystem" $targetjs;; 
xb) # Perform AIX Level 0 filesystem backup 

print -u3 "Starting AIX Level 0 backup on filesystem" Stargetjs "at' 1 S(ciate) 

backup -Sieve! -u -f $device $targetjs 

return_code=$return_code+$? 

print -u3 "Completed AIX Level 0 backup on filesystem' 1 Stargetjs "at" S(date);; 
as) # Perform ADSM Selective filesystem backup 

print -u3 "Starting ADSM Selective backup on filesystem" $targetjs "at" $(date) 
dsmc sel "Stargetjs/*" >$work_file1 
return_code=$return_code+$? 
cat Sworkjilel »$logJile 

print -u3 "\n " 

print -u3 "Completed ADSM Selective backup on filesystem" Stargetjs "at" ${date);; 
ai) # Perform ADSM Incremental filesystem backup 

print -u3 "Starting ADSM Incremental backup on filesystem" Stargetjs "at" $(date) 
dsmc i Stargetjs >$workJile1 
return_code=$retum_code+$? 
cat Sworkjilel »$logJiie 

print -u3 "\n " 

print -u3 "Completed ADSM Incremental backup on filesystem" $targetjs_pnme at 
$(date);; 

aa) # Perform ADSM Archive filesystem archive 

print -u3 "Starting ADSM Archive on filesystem" Stargetjs "at" $(date) 
dsmc archive Stargetjs/ ~des="$desc" >$workJile1 
return_code=$retu rn_code+$? 
cat Sworkjilel »$log Jile 

print -u3 "\n ,r 

print -u3 "Completed ADSM Archive on filesystem" Stargetjs "at™ $(date);; 

esac 

# Merge split filesystems if mirrored 

# NOTE!!; This section is duplicated in the fscpbk_merge.ksh 

# script. Any changes anywhere in this script should 

# probably be duplicated in that script! 
# 

if [[ Scopies -gt 1 ]]; then 

mergeJs_copy.ksh -p $fs_prime -s $fs_alt 

# merge_return_code=$merge_return_code+$? 

# fs_alt=$(print SfsJine [ cut -f 5 -d :) 

# lv_a!t=$(print SfsJine | cut -f 6 -d :) 

# target _fs=$fs__alt 
fi 
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print -u3 Titesystem" Starget Js "not mountable. Not backed 
return_code=1 

fi 

fi 

done 



exec 3<&- 



# Test for unsuccessful filesystem merges 
if [[ $merge_return_code -ne 0 ]]; then 

exit 20 

fi 

rm $lock_file 2>/dev/null 
chmod 644 $config_fiie 

# Test for unsuccessful filesystem backups 
if [[ $retum_code -ne 0 ]]; then 

exit 10 

fi 



exitO 
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#!/bin/ksh 
# 

#fscpb_merge.ksh 



# Version 0.01 

# Runs various AIX commands to merge 

# fiiesystems 

# Assembled by Carl Gusler 

# IBM Global Services 

# IBM Austin 

# cgusler@us.ibm.com 
# 

# (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 

# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, regulations, and retributions of 

# IBM Global Services 

# Intellectual Capital Management 
# 



Mmfm mmmm fiiHifiitfimitiiiifuntfftntffiiiiit 

# 

# 

# Copyright Information: Copyright !BM 1998 



# Controlled Distribution 

# Protected under the procedures, processes, rights 

# rules, and regulations of 

# IBM Global Services 

# Intellectual Property Management 
# 

# This program is an IBM Type II Deliverable as 

# described in the ISM Customer Agreement and 

# relevant IBM services contracts. 
# 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1 , Backup/archive copies taken as a normal 

# course of system maintenance. 

# 2. Copying the program to a similar machine 

# within the same enterprise. 
# 

# The customer agrees to restrict access to this 

# program as they would their own proprietary code, 

# and to notify IBM should unauthorized distribution 

# occur. 
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b0 /sf 



# 
# 

# 

#- 



This program is distributed on an "as is" basis, 
no warranty is expressed or implied. 



# 



# Description: Remerges filesystems split from mirrored LVs. 

# A cleanup utility for problem times with FSCPBK scripts 

# Operational Environment: AIX V4 

# Input: 

# Output: 

# Return Value: 

# Comments: NOTE!!: This script is an excerpt of the fscpbkjDack.ksh 

# script. If that script is edited, this one 

# should probably be edited to match. 



#_ 

# 

# Environmental Variables 
# 

# 

# Constants 

bar*= , ============~======== a 

wire— 

# Variables 

numeric_date=$(date +%m%d%y) 

text_date=$(date +%d%b%Y) 

typeset -i return_code 

typeset -i merge_return_code 

typeset -i retaindays=90 

typeset -i in_retain_days 

typeset -i copies 

typeset -i ncrement 

typeset -i mount_fs_test 

invoked_name=$0 

script_name-${invoked_name##*/} 

user_id=$(whoami) 

desc- ADSM Archive at '$text_date 

levelO 



# 



#- 
# 



# Version History: None 



# 
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# Process Control Variables 
l_flag=0 

LJIag-0 
r_flag=0 
djlag=0 

# Files 

defaultJog_dir==/var/adm/scriptlogs 

defauitJogjfile=$script_name.$text_date 

default_backup_device=/dev/rmtO. 1 

work_file1=/tmp/$script_name.$text_date.work1 

work_file2=/tmp/$script_name.$text_date.work2 

config_file=/etc/fscpbktab 

auditjile^/etc/fscpbktab.audit 

iockjile^var/locks/fscpbktab 

#. 

# 

# Function: show_usage 

# Description: Displays command usage syntax and exits 

# Input: None 

# Output: Usage message to standard error 

# Return Value: 2 

# Note: This function does not return. It completely exits. 
# 

#_ 

showjasage () 
{ 

print -u2 " 

print -u2 "Usage: fscpbkjnerge.ksh [-I directory] [-r days] " 
print -u2 " 

print -u2 " -I directory Log output directory." 
print -u2 " Default is" $defaultJog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 
print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 

} 

#. 

# 

# Korn Shell Settings 
# 

# 

#set -o errexit # Turn on error trapping and error exit mode 

#set -o noclobber # Prevent overwriting of existing files 

#set -o noexec # Perform syntax checking without execution 
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#set -o nolog # Prevents storing function defs in history file 
#set -o xtrace # Turn on debug mode 

#- 

# 

# Main Routine 
# 

# . 

# 

# Test for any passed paramaters. 
#if[$?!=0] 

#then 

# showjjsage 
#fi 

# 

log_dir-$default_log_dir 

# Parse Command Line Arguments into Variables 
while getopts l:r#c 

do 

case $c in 

!} # Set up the -I flag 
l_flag=1 

!og_dir=$OPTARG;; 
r) # Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esac 
done 

shift ${(OPTIND-1)) 

# Deal with invocation errors 
if [[ $user_id 1= root ]]; then 

show_usage 



# Configure Logging 
if [[ $l_flag -eq 1 ]J; then 

iog_fi!e=$inJog_d*r/$defaultJog_file 

mkdir -p $in_iog_dir 2>/dev/null #Create new log directory 
else 

log_file=$default_log_dir/$default_logJile 

mkdir -p $defaultJog_dir 2>/dev/null # Create default log directory 



if [[ $r_fiag -eq 1 ]]; then 

retain_days=$in_retain_days 

fi 
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# Clear old logs 

find $fog„dir -name "$script__name*" -mtime $retain_days -exec rm {} \; 

# Create new log file 

exec 3» $log_file # Open log file for writing 

print -u3 "\n==-============================= ============ 

print -u3 "= 

print -u3 "= Systems Management Transaction Log - ' 

print -u3 "= 

print -u3 "= Created by script:" $script_name 
print -u3 "= on system:* 1 $(hostname) 

print -u3 M = at :" $(date) 

print -u3"= 

print -u3 "===—=========================================== 

# Perform Work 

# Comments: NOTE!!: This script is an excerpt of the fscpbk_back.ksh 

# script. If that script is edited, this one 

# should probably be edited to match. 
# 

# Test for existing table file 
if [[ ! (-r $config__fiie) ]]; then 

print -u2 "Fatal Table error. Table file" $config_file "not found." 
print -u3 "Fatal Table error. Table file" Sconfigjile "not found . n 
exec 3<&- 
exit 99 

fi 

# Test for existing table audit file 
if [{ ! (~r $audit_file} ]]; then 

print -u2 "Fatal Table error. Table file check program must be run." 
print -u3 "Fatal Table error. Table audit file" Sauditjile "not found." 
exec 3<&- 
exit 97 

fi 

# Test for table file audit indicating syntax check since last edit 



current_Y=$(date +%Y) 

audit_stamp=$( head -1 $audit_fi!e | awk '{ print $1 }') 

# Check for colon and thus time instead of year on file datestamp 
ntest=$(ls -i $config_file j awk '{ print $8 }' [ grep : | wc -I) 
if [[ $ntest -eq 1 ]]; then 
edit_year=$current_Y 
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else 

edit_year=$(ls -I Sconfigjile | awk r { print $8 }') 

fi 



edit_month_text=$(ls -1 $config__file | awk '{ print $6 }') 
edit_day=$(ls -i $config_file | awk '{ print $7 }') 
edit_hour=${is -i Sconfigjile | awk '{ print $8 }' j cut -f 1 -d :) 
edit_mtnute=$(ls -I $configJiie | awk '{ print $8 }' | cut -f 2 -d :) 

# Determine month number from month name 

case $edit_month_text in 

Jan) edit_month=01;; 

Feb) edit_month=02;; 

Mar) ed it_month=Q3;; 

Apr) edit_month=G4;; 

May) ed it_month =05 ; ; 

Jun) edit_month=06;; 

Jul) edit__month=07;; 

Aug) edit_month =08; ; 

Sep) edit_month =09 ; ; 

Oct) edit__month=10;; 

Nov) edit_month=1 1 ;; 

Dec) editjnonth=12;; 

*) print -u2 "Fatal Table error. Table file date read error." 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 

esac 



edit_stamp=$edit_year$edit_month$edit_day$edit_hour$edit__minute 

# Test for table file audited since last editing 
if [[ $audit_stamp -le $edit_stamp ]]; then 

print -u2 "Fatal Table error. Table file edited since last checked." 

print -u3 "Fatal Table error. Table file edited since last checked/ 

exec 3<&- 

exit 97 

fi 



# Table file format 

# Format: bc:pfs:piv:c:afs:alv 

# xb:/home:hd1 :2:/alt/home:/a!tlvh 
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ncrement=0 

return_code=0 

merge_return_code=0 

# Cycle through fifesystems and perform merges 
for fsjine in $(cat $config_file | grep -v A #) 

do 

action-$(print $fsjine | cut-f 1 -d :) 
fs_prime=$(print $fsjine | cut -f 2 -d :) 
lv_prime=$(print $fs_line j cut-f 3 -d ;) 
fs__a[t=$(print $fs_line | cut -f 5 -d :) 
lv_alt=S(print Sfsjine | cut -f 6 -d :) 
copies=$(print $fs_iine | cut -f 4 -d :) 
target_fs=$fs_prime 

print -u3 $action $fs_prime $iv_prime $copies 
if [[ $action l= no ]]; then 

# Merge split filesystems if mirrored 
if [[ Scopies -gt 1 ]]; then 

merge_fs_copy.ksh -p $fs_prime -s $fs_alt 
rnerge_return_code=$merge_return_code+$? 

fi 

fi 

done 



exec 3<&- 

# Test for unsuccessful filesystem merges 
if [[ $merge_return_code -ne 0 ]]; then 

exit 20 

fi 

# Remove lock on table file 
rm Stockjile 2>/dev/nuil 
chmod 644 $config_fiie 

exitO 
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